---
title: "List supported parks"
method: GET
path: "/v1/parks"
tags: ["Parks"]
---

# List supported parks

`GET /v1/parks`

## Request

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

Every supported park with its key, canonical ID, destination, IANA time zone and Parky page.

## Response `200`

Success.

- ParksResponse
  - `schema_version` 1, required: Response format version. Fields are only added within a version.
  - `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
  - `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)
