# Theme-park ticket calendar: `POST /v1/attractions/calendar`

Cost: 4 credits (4 per started 31 days, plus 2 per started 31 days with include_capacity (a calendar with no priced date, an unknown park and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/attractions-calendar

A theme park's day tickets for every visit date in a range.

Name the park by `park` id (from GET /v1/attractions/parks) or by its
website `url`. Each date has a `status` (`open`, `closed`, `sold_out`,
or `unavailable` when the park's shop lists nothing for it), the
headline `price` (the cheapest adult or one-price day ticket; free
tickets never count), `availability` where the park shows it, and every
ticket with `price`, `price_before_tax`, `tax` and `list_price` (the
gate or undiscounted price). `summary.cheapest_dates` lists the lowest
priced open dates. Prices are in the park's own currency.

With `include_capacity`, each date also carries `capacity`: the park's
daily capacity (`total`), tickets sold (`sold`), `remaining` and
`percent_available`, each only where the park's shop states it (null
otherwise, and the whole object null for parks that show none).

Request body (JSON):

- `park` (string | null; optional; pattern ^[a-z0-9-]{2,60}$): Park id from GET /v1/attractions/parks, e.g. `dollywood` or `alton-towers`.
- `url` (string | null; optional; max length 500): The park's website or ticket-shop URL, instead of `park`. Parks sharing one site are told apart by path (`https://www.sixflags.com/knotts`).
- `start_date` (string (date) | null; optional): First visit date, `YYYY-MM-DD`; defaults to today where the park is.
- `days` (integer; optional; default 31; min 1, max 92): Visit dates to return from start_date, 1 to 92. Each started 31 days is billed separately.
- `include_capacity` (boolean; optional; default false): Also return each date's capacity numbers (daily capacity, tickets sold, remaining, percent available) where the park's shop states them. Only for parks whose `capacity` is true in GET /v1/attractions/parks (others answer 422, free). Adds 2 credits per started 31 days.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)