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

> Plan your theme park visits with real-time wait times, operating schedules, attraction details, show information, and dining options across parks worldwide. Search for specific parks, explore attractions and restaurants, view park maps, and check schedules by month to optimize your experience.

**Category:** Travel | **Website:** [themeparks.com/](https://themeparks.com/) | **Docs:** [parse.bot/marketplace/b251eaf6-69bc-4b50-bf91-06bb82bb454d/themeparks-com-api](https://parse.bot/marketplace/b251eaf6-69bc-4b50-bf91-06bb82bb454d/themeparks-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-themeparks-com-api-b251eaf6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_destinations

Returns all supported theme park destinations globally, each with its constituent parks. A destination is a resort-level grouping (e.g. Walt Disney World Resort) containing one or more parks.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_destinations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_entity

Returns detailed metadata for a specific entity (destination, park, attraction, show, or restaurant) by its UUID. Includes location coordinates, timezone, parent relationships, and external identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the entity. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_entity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### get_entity_children

Returns all child entities for a given entity. For a park, this includes all attractions, shows, and restaurants within it. Each child includes its type, location, and identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the parent entity. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_entity_children \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### get_entity_live_data

Returns real-time live data for a given entity and all its children, including current wait times, operating status, queue information, wait time forecasts, show times, and operating hours. Updated continuously throughout the day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the entity. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_entity_live_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### get_entity_schedule

Returns the full operating schedule/calendar for a given entity, including all future dates with opening/closing times, event types, and Lightning Lane pricing where available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the entity. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_entity_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### get_entity_schedule_by_month

Returns the operating schedule for a specific year and month for a given entity. Includes pricing info for Lightning Lane passes where available. Defaults to the current month if year/month are omitted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the entity. |
| `month` | string | No | 2-digit month with leading zero (e.g. '06'). Defaults to the current month if omitted. |
| `year` | string | No | 4-digit year (e.g. '2026'). Defaults to the current year if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_entity_schedule_by_month \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>","month":"<string>","year":"<string>"}'
```

### get_park_attractions

Returns the full list of rides and attractions for a park, filtering children to only ATTRACTION entity types. Each attraction includes its name, location, slug, and identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the park. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_park_attractions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### get_park_map

Returns the global map view with all parks worldwide, their current open/closed status, location coordinates, aggregate statistics including global average wait time, and a sample of the most recent wait time reports.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_park_map \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_park_restaurants

Returns all dining options for a park, filtering children to only RESTAURANT entity types. Each restaurant includes its name, location, slug, and identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the park. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_park_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### get_park_wait_times

Returns attraction wait time data for a park. Filters live data to only include entities of type ATTRACTION, each with queue wait times, operating status, wait time forecasts, and operating hours.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | UUID of the park. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/get_park_wait_times \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"<string>"}'
```

### search_parks

Search for parks globally by name. Returns all parks when no query is provided, or filters by case-insensitive substring match on park name. Each park includes current open/closed status, location, and attraction/show counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search keyword to filter parks by name. Omitting returns all parks. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themeparks-com-api-b251eaf6/search_parks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```