Rides

Best times to ride

Parky's hourly predicted waits (with bounds) for a park-local date up to 30 days ahead, the typical wait by hour for that weekday, Disney's own hourly forecast when Disney publishes one (disney_forecast, usually today only), and a summary with the best one or two windows and the worst window. Later dates fall back to typical waits (summary.basis). Returns 403 rights_unavailable when the server has provider-derived data disabled.

get/v1/rides/{ride}/best-times

Request

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

Path parameters

ridestring required

Ride ID from GET /v1/parks/{park}/rides (for example magic-kingdom_seven-dwarfs-mine-train). A ride name or slug also works when it is unique.

Query parameters

datestring date

First park-local date, YYYY-MM-DD, from today through 29 days ahead. Defaults to today in the park's time zone.

Response

Success.

schema_version1 required

Response format version. Fields are only added within a version.

ride_idstring required

ride_namestring

park_idstring

park_namestring

time_zonestring

datestring date required

day_of_weekstring

prediction_generated_atstring date-time nullable

model_versionstring nullable

data_status'predicted' | 'typical_only' | 'unavailable'

notestring

docs_urlstring uri required

Developer documentation.

generated_atstring date-time required

When Parky built this response.

Example response

{
  "schema_version": 1,
  "ride_id": "magic-kingdom_seven-dwarfs-mine-train",
  "ride_name": "Seven Dwarfs Mine Train",
  "park_id": "disney-walt-disney-world-resort-magic-kingdom-park",
  "park_name": "Magic Kingdom Park",
  "time_zone": "America/New_York",
  "date": "2026-10-06",
  "day_of_week": "Tuesday",
  "predicted_hours": [
    {
      "hour": 9,
      "local_time": "09:00",
      "predicted_wait_minutes": 45,
      "lower_bound": 38,
      "upper_bound": 52,
      "park_closed": false
    }
  ],
  "typical_hours": [
    {
      "hour": 9,
      "local_time": "09:00",
      "typical_wait_minutes": 40,
      "days_observed": 8
    }
  ],
  "summary": {
    "basis": "predicted",
    "best_windows": [
      {
        "start": "20:00",
        "end": "22:00",
        "start_hour": 20,
        "end_hour": 22,
        "average_wait_minutes": 27.5
      }
    ],
    "worst_window": {
      "start": "12:00",
      "end": "14:00",
      "start_hour": 12,
      "end_hour": 14,
      "average_wait_minutes": 70
    }
  },
  "disney_forecast": {
    "hours": [
      {
        "hour": 9,
        "local_time": "09:00",
        "forecast_at": "2026-10-06T13:00:00.000Z",
        "wait_minutes": 40,
        "busyness_percent": 31
      }
    ],
    "captured_at": "2026-10-06T11:05:40.117Z",
    "data_status": "available",
    "note": "Disney publishes this forecast for today and sometimes tomorrow only."
  },
  "prediction_generated_at": "2026-10-05T10:22:35.000Z",
  "model_version": "park-window-time-of-day-v4",
  "data_status": "predicted",
  "note": "Hours are park-local. Predictions and typical waits are estimates, not guarantees.",
  "docs_url": "https://parkypass.com/developers",
  "attribution": {
    "text": "Live data from parkypass.com",
    "url": "https://parkypass.com/parks/magic-kingdom",
    "required": true
  },
  "generated_at": "2026-10-05T16:45:02.118Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.