# Queue Times — 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.

> Monitor real-time wait times, crowd levels, and historical data across 130+ theme parks worldwide to plan your visits and avoid peak hours. Get daily statistics and predictions to make informed decisions about when and where to experience attractions with minimal wait times.

**Category:** Travel | **Website:** [queue-times.com/](https://queue-times.com/) | **Docs:** [parse.bot/marketplace/d79c67c4-aa48-4fe8-8075-7a8f2ff05fcd/queue-times-com-api](https://parse.bot/marketplace/d79c67c4-aa48-4fe8-8075-7a8f2ff05fcd/queue-times-com-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/queue-times/`
**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 daily stats

Returns historical statistics for one park on a specific calendar date. Includes overall crowd level (e.g. 'Quiet', 'Moderate', 'Busy'), prediction error percentage, and per-attraction average and maximum wait times observed that day. Data is extracted from the site's calendar pages; availability depends on the park and date range the site has recorded.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `day` | string | Yes | Day of the month from 1 to 31 (e.g. "3"). |
| `month` | string | Yes | Month as a number from 1 to 12 (e.g. "8" for August). |
| `park_id` | string | Yes | Numeric park ID obtained from the list_parks endpoint. |
| `year` | string | Yes | Year in YYYY format (e.g. "2024"). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/queue-times/get-daily-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"day":"<string>","month":"<string>","park_id":"<string>","year":"<string>"}'
```

### Get park queue times

Returns current real-time queue/wait times for every attraction in a park, organized by themed land. Each ride includes its current wait time in minutes and open/closed status. Rides not assigned to any land appear in a top-level rides array. Data refreshes every few minutes; last_updated timestamps indicate freshness.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `park_id` | string | Yes | Numeric park ID obtained from the list_parks endpoint (e.g. "16" for Disneyland). |

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

### List parks

Returns all theme parks grouped by parent company. Each company entry contains its parks with geographic metadata (country, continent, coordinates, timezone). The full catalog is returned in a single response — no pagination required. Use park IDs from this response as input to get_park_queue_times and get_daily_stats.

**Estimated cost:** Metered

_No parameters required._

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

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