---
title: "Live waits for a park"
method: GET
path: "/v1/parks/{park}/waits"
tags: ["Live"]
---

# Live waits for a park

`GET /v1/parks/{park}/waits`

## Request

- Base URL: `https://api.parkypass.com`
- URL: `https://api.parkypass.com/v1/parks/{park}/waits`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Parky-Key`

Rides, walk-through attractions and shows with their posted standby wait, status, Single Rider wait and Lightning Lane return window, from one shared snapshot refreshed at most every 5 seconds. Queued rides (`type: "ride"`) are always listed, with status `unavailable` and null waits when no live value is reported. Walk-through attractions (`experience`), shows (`show`) and character meets (`meet`) are listed only while reported. When the park has no current live data, `data_status` is `unavailable`. Posted waits typically change every few minutes; to follow changes, use the stream instead of polling. Returns 403 rights_unavailable when the server has provider-derived data disabled.

## Path parameters

- `park` string, required

## Response `200`

Success.

- ParkWaitsResponse
  - `park_id` string, required
  - `park_key` string, required
  - `park_name` string, required
  - `time_zone` string, required
  - `data_status` 'live' | 'unavailable', required: `live` when the park has current live data.
  - `feed` 'disney_direct' | 'universal_direct' | 'null', nullable, required: The park's own live feed while it is healthy.
  - `park_open` boolean, nullable, required
  - `checked_at` string, date-time, nullable, required: When Parky last read the feed snapshot.
  - `data_age_seconds` integer, nullable, required
  - `rides` LiveRide[], required
    - `ride_id` string, required: Parky ride ID; use it with /v1/rides/{ride}.
    - `name` string, required
    - `type` 'ride' | 'experience' | 'show' | 'meet', required: `ride`: a queued ride, always listed. `experience`: a walk-through or open attraction (Swiss Family Treehouse, Walt Disney World Railroad). `show`: a show the feed posts a wait for (Mickey's PhilharMagic). `meet`: a character meet (Meet Mickey at Town Square Theater); filter these out to show rides and shows only.
    - `status` 'OPERATING' | 'DOWN' | 'CLOSED' | 'REFURBISHMENT' | 'UNKNOWN' | 'unavailable', required: Operator status; `unavailable` means no live value is reported for this ride.
    - `is_open` boolean, nullable, required: True when the ride and park are open; null when unavailable.
    - `wait_minutes` integer, nullable, required: Posted standby wait; null when closed or unavailable (never 0 for unknown).
    - `single_rider_available` boolean, nullable, required
    - `single_rider_wait_minutes` integer, nullable, required
    - `lightning_lane` LightningLane, nullable, required: The ride's current Lightning Lane return window. Multi Pass is preferred when a ride has both.
      - `type` 'multi_pass' | 'single_pass', required
      - `state` string, nullable, required: AVAILABLE, or FINISHED when sold out for the day.
      - `return_start` string, date-time, nullable, required: Next return window start (when AVAILABLE).
      - `return_end` string, date-time, nullable, required: Next return window end.
      - `price` object, nullable, required: Single Pass price when shown.
        - `amount` number
        - `currency` string, nullable
    - `changed_at` string, date-time, nullable, required: When this ride's value last changed. Not a freshness time: data is current whenever data_status is live.
  - `schema_version` 1, required: Response format version. Fields are only added within a version.
  - `note` string
  - `docs_url` string, uri, required: Developer documentation.
  - `attribution` Attribution, required: Required credit. Wherever Parky data is shown, display `text` with a visible link to `url`; the link must stay visible.
    - `text` 'Live data from parkypass.com', required: Text to display.
    - `url` string, uri, required: The matching parkypass.com page to link.
    - `required` true, required: Always true: attribution is a condition of use.
  - `generated_at` string, date-time, required: When Parky built this response.

## Other responses

- `400`: Invalid input, such as a malformed date or out-of-range days. The message says the accepted range.
- `401`: Malformed, unknown or revoked key. Drop the key to use anonymous limits.
- `403`: Provider-derived data (waits, Lightning Lane, hours, best times, reliability) is disabled on this server.
- `404`: Unknown park or ride. The message lists valid park keys or how to find ride IDs.
- `429`: Rate limit or stream limit reached.
- `503`: Parky's upstream data is unavailable or its read budget is spent. Retry after Retry-After.

---

[API](https://skmtc.dev/parkypass/apis/parky-api.md) · [All operations](https://skmtc.dev/parkypass/apis/parky-api/llms.txt) · [OpenAPI document](https://skmtc.dev/parkypass/apis/parky-api/revisions/c3abcb8be74f?raw)