---
title: "Hotel availability"
method: GET
path: "/v1/resorts/{resort}/hotel-availability"
tags: ["Resorts"]
---

# Hotel availability

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

## Request

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

Per night: how many of the resort's hotels are sold out and the median rate; per hotel and night: availability, the lowest rate for two adults and rooms left at it, as Disney or Universal showed Parky on its last daily check. Up to 14 nights within the next 120 days. 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.

- HotelAvailabilityResponse
  - `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
  - `nights` object[], required
    - `night` string, date
    - `hotels_checked` integer, nullable
    - `hotels_sold_out` integer, nullable
    - `sold_out_share` number, nullable
    - `median_rate` number, nullable
    - `rate_index` number, nullable: Median of each hotel's rate relative to its own typical rate (1.0 = typical).
    - `rooms_left_at_lowest_rate` integer, nullable
    - `captured_at` string, date-time, nullable
  - `hotels` object[], required
    - `hotel_id` string
    - `name` string, nullable
    - `tier` string, nullable
    - `night` string, date
    - `adults` integer, nullable
    - `available` boolean, nullable
    - `rate` number, nullable
    - `rack_rate` number, nullable
    - `room_type` string, nullable
    - `rooms_left` integer, nullable
    - `currency` string
    - `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)