# AMC Theatres — 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.

> Find movie showtimes and browse theatre locations across AMC Theatres, with the ability to filter by specific theatre, date, and market area. Quickly discover what's playing and plan your cinema visits with current availability at your preferred locations.

**Category:** Entertainment | **Website:** [www.amctheatres.com/](https://www.amctheatres.com/) | **Docs:** [parse.bot/marketplace/806399d8-6960-4d3e-9ea0-da32b3129d63/amctheatres-com-api](https://parse.bot/marketplace/806399d8-6960-4d3e-9ea0-da32b3129d63/amctheatres-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/amc-theatres/`
**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 seating layout

Get the seating layout for a specific AMC showtime. Returns the full auditorium seat map including each seat's row, number, type (standard, wheelchair, companion), tier, and availability (available, taken, unavailable). Seats that are not real seats (gaps in the layout) are excluded. Use a showtime_id from get_showtimes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `showtime_id` | string | Yes | Showtime identifier from get_showtimes (e.g. 'U2hvd3RpbWU6MTQ1MjU0NzQ5'). |

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

### Get showtimes

Get movie showtimes for a specific AMC theatre. Returns all movies currently playing with their showtimes grouped by format (IMAX, Dolby Cinema, Laser, etc.), including language/audio details, duration, rating, poster, amenities, and availability status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format to filter showtimes. When omitted, returns the current day's showtimes. |
| `theatre` | string | No | Theatre slug (e.g., 'amc-empire-25', 'amc-burbank-16'). Use list_theatres to discover valid slugs for a market. |

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

### List theatres

List AMC theatres available in a given market. Returns theatre names, slugs, city, and state that can be used with get_showtimes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `market` | string | No | Market/city slug (e.g., 'new-york-city', 'los-angeles') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amc-theatres/list-theatres \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"market":"<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.