---
title: "One ride"
method: GET
path: "/v1/rides/{ride}"
tags: ["Rides"]
---

# One ride

`GET /v1/rides/{ride}`

## Request

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

A ride's facts, its live wait (`live`) and 30-day reliability summary (`reliability`). `live` and `reliability` are omitted when the server has provider-derived data disabled.

## Path parameters

- `ride` string, required

## Response `200`

Success.

- RideResponse
  - `ride_id` string, required
  - `name` string, required
  - `park_id` string, required
  - `park_key` string, required
  - `park_name` string, required
  - `land` string, nullable: The ride's land, from the park's own catalog (Disney parks).
  - `ride_type` string, nullable: Curated type such as `launched roller coaster`, else the catalog type (attraction, show).
  - `is_attraction` boolean, nullable
  - `has_lightning_lane` boolean, nullable
  - `height_requirement_inches` number, nullable
  - `duration_seconds` number, nullable
  - `location` object, nullable
    - `latitude` number
    - `longitude` number
  - `facts` object, required: Reviewed facts when present: height_inches, duration_seconds, duration_minutes, top_speed_mph, drop_feet, opened_year, single_rider, rider_swap, transfer_required, wheelchair_access, kid_intensity, kid_scare_factors, locker_policy, facts_source_url, facts_reviewed_at.
  - `url` string, uri, required: The ride's parkypass.com page.
  - `updated_at` string, date-time, nullable: Last catalog update.
  - `schema_version` 1, required: Response format version. Fields are only added within a version.
  - `live` object: Omitted when provider-derived data is disabled.
    - `data_status` 'live' | 'unavailable'
    - `feed` string, nullable
    - `park_open` boolean, nullable
    - `checked_at` string, date-time, nullable
    - `wait` LiveRide: 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.
      - `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.
  - `reliability` ReliabilityRide
    - `ride_id` string, required
    - `name` string, required
    - `uptime_pct` number, nullable, required: Percent of open-park minutes the ride was not down.
    - `outages` integer, nullable, required
    - `outages_per_day` number, nullable, required
    - `average_outage_minutes` number, nullable
    - `longest_outage_minutes` number, nullable
    - `days_observed` integer, nullable, required
    - `down_minutes` number, nullable
    - `operating_minutes` number, nullable
  - `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.
- `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)
