---
title: "GET /v1/entity/{id}/schedule/{year}/{month}"
method: GET
path: "/v1/entity/{id}/schedule/{year}/{month}"
tags: ["v1"]
---

# GET /v1/entity/{id}/schedule/{year}/{month}

`GET /v1/entity/{id}/schedule/{year}/{month}`

## Path parameters

- `id` string, required
- `year` string, required
- `month` string, required

## Response `200`

Successful response

- EntityScheduleResponse
  - `id` string — Entity identifier
  - `name` string — Entity name
  - `entityType` 'DESTINATION' | 'PARK' | 'ATTRACTION' | 'RESTAURANT' | 'HOTEL' | 'SHOW' — Type of entity in the theme park system
  - `timezone` string — Entity timezone
  - `schedule` EntityScheduleEntry[]
    - `date` string, required — The date of the schedule entry
    - `type` string, required — Type of schedule entry e.g. OPERATING, EXTRA_HOURS, etc.
    - `description` string — Optional description of the schedule entry
    - `openingTime` string, required — Opening time for this schedule entry
    - `closingTime` string, required — Closing time for this schedule entry
  - `parks` ParkSchedule[] — Only included for destinations, lists all parks within the destination
    - `id` string — Entity identifier
    - `name` string — Entity name
    - `entityType` 'DESTINATION' | 'PARK' | 'ATTRACTION' | 'RESTAURANT' | 'HOTEL' | 'SHOW' — Type of entity in the theme park system
    - `timezone` string — Entity timezone
    - `schedule` PricedScheduleEntry[]
      - `date` string, YYYY-MM-DD, required — Schedule date
      - `openingTime` string, date-time, required — Opening time
      - `closingTime` string, date-time, required — Closing time
      - `type` 'OPERATING' | 'TICKETED_EVENT' | 'PRIVATE_EVENT' | 'EXTRA_HOURS' | 'INFO', required — Type of schedule entry
      - `purchases` SchedulePriceObject[] — Available purchases for this schedule entry
        - `type` 'ADMISSION' | 'PACKAGE' | 'ATTRACTION' — Type of schedule price
        - `id` string — Unique identifier
        - `name` string — Name of the price object
        - `price` object
          - `amount` number, required — Price amount
          - `currency` string, required — Currency code
          - `formatted` string — Formatted price string
        - `available` boolean — Whether this price option is available

## Other responses

- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/themeparks/apis/v1-api.md) · [All operations](https://skmtc.dev/themeparks/apis/v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/themeparks/v1-api/revisions/38d9a8a607bb/schema)