---
title: "List supported resorts"
method: GET
path: "/v1/resorts"
tags: ["Resorts"]
---

# List supported resorts

`GET /v1/resorts`

## Request

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

Every supported resort with its key, aliases, time zone and parks.

## Response `200`

Success.

- ResortsResponse
  - `schema_version` 1, required: Response format version. Fields are only added within a version.
  - `resorts` Resort[], required
    - `id` string, required
    - `key` 'walt-disney-world' | 'disneyland-resort' | 'universal-orlando' | 'universal-studios-hollywood', required
    - `name` string, nullable, required
    - `aliases` string[], required
    - `time_zone` string, nullable, required
    - `parks` Park[], required
      - `id` string, required: Canonical park ID.
      - `key` string, required: Short park key used in URLs.
      - `name` string, required
      - `destination` object, required
        - `id` string, nullable, required
        - `name` string, nullable, required
      - `resort_key` string, nullable: Key for /v1/resorts/{resort}.
      - `time_zone` string, required: IANA time zone for park-local dates and hours.
      - `url` string, uri, required
    - `url` string, uri, required
  - `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.
- `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)