# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-amctheatres-com-api-806399d8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-amctheatres-com-api-806399d8/get_seating_layout \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amctheatres-com-api-806399d8/get_showtimes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amctheatres-com-api-806399d8/list_theatres \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"market":"<string>"}'
```
