---
title: "Park reservation availability"
method: GET
path: "/v1/resorts/{resort}/park-availability"
tags: ["Resorts"]
---

# Park reservation availability

`GET /v1/resorts/{resort}/park-availability`

## Request

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

Park reservation and blockout availability per park and segment (ticket or pass type, such as `broad` tickets or an annual pass tier) for up to 31 days, from Disney's and Universal's own calendars. Returns 403 rights_unavailable when the server has provider-derived data disabled.

## Path parameters

- `resort` string, required

## Query parameters

- `date` string, date
- `days` integer

## Response `200`

Success.

- ParkAvailabilityResponse
  - `schema_version` 1, required: Response format version. Fields are only added within a version.
  - `resort_id` string, required
  - `resort_key` string
  - `resort_name` string, nullable
  - `requested_from` string, date
  - `requested_to` string, date
  - `days` object[], required
    - `date` string, date
    - `parks` object[]
      - `park_key` string
      - `segments` object[]
        - `segment` string: Ticket or pass type: broad (date-based tickets), florida, military, ap_* (annual pass tiers), and so on.
        - `available` boolean, nullable
        - `fully_booked` boolean, nullable
        - `blocked` boolean, nullable: Blocked out for this pass type.
        - `captured_at` string, date-time, nullable
  - `data_status` 'available' | 'unavailable'
  - `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)