# District — 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 movies currently playing in theaters across Indian cities to discover what's showing near you. Browse showtimes and film details powered by District by Zomato's comprehensive movie database.

**Category:** Entertainment | **Website:** [district.in/](https://district.in/) | **Docs:** [parse.bot/marketplace/802af38b-8067-4aec-a38b-7e06c6633025/district-in-api](https://parse.bot/marketplace/802af38b-8067-4aec-a38b-7e06c6633025/district-in-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/district/`
**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 showtimes

Returns theatres and showtimes for a specific movie in a given city and date. Each theatre includes its name, address, location, and a list of showtimes. Each showtime includes the time, screen format, auditorium name, available/total seats, seat category breakdown with prices, booking URL, and cancellation policy. When date is omitted, returns today's shows. The show_dates array lists all dates with available screenings. Uses movie_id from get_movies_in_theaters results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City name to get showtimes for (e.g. Mumbai, Bengaluru, Delhi NCR, Chennai). |
| `date` | string | No | Date in ISO format YYYY-MM-DD to get showtimes for. When omitted, returns today's shows. Must be within the movie's available show_dates range. |
| `movie_id` | string | Yes | Movie ID from get_movies_in_theaters (e.g. '194046'). |

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

### Get movies in theaters

Returns all movies currently showing in theaters for a given city. Each movie includes title, genres, duration, censor rating, release date, available languages and formats, description, and poster image. The city parameter matches against the site's city catalog which includes Indian cities, Abu Dhabi, and Dubai. When city is omitted, defaults to Mumbai.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City name to filter movies by (e.g. Mumbai, Bengaluru, Delhi NCR, Chennai, Hyderabad, Pune, Kolkata, Ahmedabad). Matched case-insensitively against the site's city catalog. |

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