# Yorck — 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.

> Browse current and upcoming films at Berlin's Yorck Kinogruppe cinemas, check showtimes and schedules, and explore special events and membership options. Search for movies, view detailed cinema information, and plan your visits with comprehensive scheduling data across the entire theater chain.

**Category:** Entertainment | **Website:** [yorck.de/](https://yorck.de/) | **Docs:** [parse.bot/marketplace/98566fbd-90f5-4ab3-ba15-b434e3f3f71a/yorck-de-api](https://parse.bot/marketplace/98566fbd-90f5-4ab3-ba15-b434e3f3f71a/yorck-de-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/yorck/`
**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 cinema detail

Get detailed information for a specific cinema including address, history, accessibility details, gallery, transport info, screen info, and air conditioning details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cinema_slug` | string | Yes | URL slug of the cinema, obtainable from list_cinemas results (e.g. 'delphi-filmpalast', 'babylon-kreuzberg'). |

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

### Get cinema showtimes

Get films and showtimes at a specific cinema for a given date. Returns both regular films and special events scheduled at that cinema, each with embedded session times.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cinema_slug` | string | Yes | URL slug of the cinema, obtainable from list_cinemas results. |
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns the default schedule. |

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

### Get coming soon

Get films coming soon to Yorck cinemas. Returns upcoming releases not yet in regular rotation, each with slug, runtime, release date, and synopsis.

**Estimated cost:** Metered

_No parameters required._

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

### Get film detail

Get detailed information for a specific film including cast, director, synopsis, trailer YouTube IDs, poster, countries, and current sessions. The film_slug is obtainable from get_now_playing or search_films results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `film_slug` | string | Yes | URL slug of the film, obtainable from get_now_playing or search_films results (e.g. 'disclosure-day'). |

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

### Get film showtimes

Get showtimes for a specific film, optionally filtered by date. Returns session objects with start times, screening formats (DF/OV/OmU), and cinema name. Without a date filter, all scheduled sessions are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Filter sessions by date in YYYY-MM-DD format. Omitting returns all available sessions. |
| `film_slug` | string | Yes | URL slug of the film, obtainable from get_now_playing or search_films results. |

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

### Get now playing

Get films currently showing across all Yorck cinemas. Returns the full roster of films in regular rotation with embedded session previews (next 3 showtimes per film). Each film carries a slug for drill-down via get_film_detail.

**Estimated cost:** Metered

_No parameters required._

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

### Get special detail

Get details for a specific special event or film series including assigned films, cinema locations, schedule, description, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `special_slug` | string | Yes | URL slug of the special, obtainable from list_specials results (e.g. 'mongay', 'creepy-crypt', 'in-the-mood'). |

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

### Get unlimited membership info

Get details about the Yorck Unlimited membership subscription including pricing, benefits, and FAQs. Fetches content from the Contentful-powered experience page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/yorck/get-unlimited-membership-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get week schedule

Get the full weekly film schedule across all Yorck cinemas. Returns all films currently showing with their embedded sessions for the week.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Start date for the weekly schedule in YYYY-MM-DD format. Omitting defaults to the current week. |

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

### List cinemas

List all Yorck Kinogruppe cinema locations with full details including name, address, district, slug, number of auditoriums, accessibility info, and short description.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/yorck/list-cinemas \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List specials

List all special programming, film series, and festivals at Yorck cinemas. Returns three arrays: active specials (one-off screenings), recurring film series, and festivals.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/yorck/list-specials \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search films

Search for films by keyword among currently playing films. Performs case-insensitive substring matching against film titles. Returns matching films in the same structure as get_now_playing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against film titles (case-insensitive substring match). |

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