Parks

Crowd forecast

Parky's 1-10 crowd forecast with a low-high range and drivers for up to 30 park-local days, plus the model's measured accuracy (accuracy). Today's level follows observed waits once the park has an hour of them.

get/v1/parks/{park}/crowds

Request

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

Path parameters

parkstring required
Example:magic-kingdom

Park key (magic-kingdom), canonical park ID, park name, or shorthand such as mk, dca or ioa. Case-insensitive. See GET /v1/parks.

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.

daysinteger

Number of consecutive days, 1 to 30. Defaults to 1.

Response

Success.

schema_version1 required

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

park_idstring required
park_namestring
time_zonestring
requested_fromstring date
requested_tostring date
missing_datesstring[]
data_status'available' | 'partial' | 'unavailable' required
notestring
docs_urlstring uri required

Developer documentation.

generated_atstring date-time required

When Parky built this response.

Example response

{
  "schema_version": 1,
  "park_id": "disney-walt-disney-world-resort-magic-kingdom-park",
  "park_name": "Magic Kingdom Park",
  "time_zone": "America/New_York",
  "days": [
    {
      "date": "2026-10-11",
      "crowd_level": 7,
      "level_low": 6,
      "level_high": 8,
      "drivers": [
        {
          "label": "Fall break week",
          "effect": 1.2
        }
      ],
      "notes": [
        "Halloween party night: park closes at 6 pm for day guests."
      ],
      "generated_at": "2026-10-05T09:12:00.000Z"
    }
  ],
  "requested_from": "2026-10-11",
  "requested_to": "2026-10-11",
  "missing_dates": [],
  "data_status": "available",
  "note": "This is a forecast, not a guarantee of crowd size or wait time.",
  "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.