# Cinemark — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for Cinemark theater locations and movies, then browse showtimes and ticket prices to plan your movie outing. Get detailed information about available films across all US Cinemark locations to compare options and find the perfect showtime for you.

**Category:** Entertainment | **Website:** [www.cinemark.com/](https://www.cinemark.com/) | **Docs:** [parse.bot/marketplace/0509869f-b4a7-4456-9b22-235f9ad5760c/cinemark-com-api](https://parse.bot/marketplace/0509869f-b4a7-4456-9b22-235f9ad5760c/cinemark-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/cinemark/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get movie details

Returns detailed information about a specific movie including synopsis, full cast, genres, trailer URL, and rating. The slug is obtained from the get_movies endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Movie URL slug from get_movies (e.g. the-odyssey, moana). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cinemark/get-movie-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get movies

Returns the Cinemark movie catalog. Without a status filter, returns all currently showing movies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Filter by movie status. Omitting returns now-showing movies. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cinemark/get-movies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>"}'
```

### Get showtimes

Returns session-level showtimes for a specific theater. Each showtime includes movie name, session ID, date/time, format, and accessibility attributes. Identify the theater by slug (theater_id from get_theaters) or by display name (theater_name for fuzzy case-insensitive lookup). When theater_name matches multiple theaters, returns a disambiguation list instead of showtimes. Results include the numeric theaterId and movieId needed by get_ticket_prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns today's showtimes. |
| `theater_id` | string | No | Theater path slug from get_theaters id field (e.g. va-fairfax/cinemark-fairfax-corner-and-xd). Either theater_id or theater_name is required. |
| `theater_name` | string | No | Theater display name for fuzzy case-insensitive lookup (e.g. Cinemark Fairfax Corner and XD). Either theater_id or theater_name is required. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cinemark/get-showtimes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","theater_id":"<string>","theater_name":"<string>"}'
```

### Get theaters

Returns all US Cinemark theater locations. When a state filter is applied (and the result set is 20 or fewer), each theater includes full address and available format details fetched from its detail page. Without filter, returns basic info (name, city, state, URL slug) for all 300+ locations. The id field is the theater path slug used by get_showtimes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | Two-letter US state abbreviation to filter theaters (e.g. VA, TX, CA). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cinemark/get-theaters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### Get ticket prices

Returns ticket types and prices for a specific showtime session. All parameters are obtained from the get_showtimes response fields: theaterId, sessionId, movieId, and sessionDateTime.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_id` | string | Yes | Cinemark movie ID from get_showtimes movieId field (e.g. 108919). |
| `showtime_datetime` | string | Yes | Session datetime from get_showtimes sessionDateTime field (e.g. 2026-07-19T14:50:00). |
| `showtime_id` | string | Yes | Session ID from get_showtimes sessionId field (e.g. 306627). |
| `theater_id` | string | Yes | Numeric theater ID from get_showtimes theaterId field (e.g. 1111). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cinemark/get-ticket-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"movie_id":"<string>","showtime_datetime":"<string>","showtime_id":"<string>","theater_id":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.