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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-district-in-api-802af38b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-district-in-api-802af38b/get_movie_showtimes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-district-in-api-802af38b/get_movies_in_theaters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```