---
title: "Product calendar"
method: GET
path: "/products/calendar"
tags: ["Availability & Pricing API"]
---

# Product calendar

`GET /products/calendar`

## Query parameters

- `product_ids` string, required
- `lang` string
- `start_date` string, date — First day for which to return availability.
- `end_date` string, date — Last day for which to return availability (by default: 31 days from current date). We capped the endpoint response to a maximum of 31 days per request to manage the response time of the endpoint.

## Headers

- `Authorization` string, required

## Response `200`

Successful operation.

- object
  - `success` boolean
  - `products` Calendar[]
    - `product_id` integer — ID of the product.
    - `title` string — Product title.
    - `capped_at` string, date, nullable — The capped date that is used to limit the availability information in the response. For example, *capped_at* 2020-08-19 means the last information in the response is 2020-08-18. We capped the endpoint response to a maximum of 31 days per request to manage the response time of the endpoint. Format YYYY-MM-DD.
    - `next_available_date` string, date, nullable — First available date for the product. Format YYYY-MM-DD.
    - `availability` object — Availability information for the product.
      - `date` string, date — Date of the availability information. Format YYYY-MM-DD.
      - `available` boolean — Indication of the product is available at the given date. `true` means that there is availability for the date, `false` means that the date is fully unavailable.

## Other responses

- `400` — Bad Request -- Check your request parameters (typo in parameter or invalid value).
- `401` — Unauthorized -- Your API key is incorrect.
- `403` — Forbidden -- The endpoint or parameters are not allowed for the matching API key.
- `404` — Not Found -- Requested resource/endpoint could not be found.
- `405` — Method Not Allowed -- Check your request method.
- `429` — Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.
- `500` — Internal Server Error -- We had a problem with our server. Try again later.
- `503` — Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

---

[API](https://skmtc.net/tiqets/apis/tiqets-distributor-api.md) · [All operations](https://skmtc.net/tiqets/apis/tiqets-distributor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiqets/tiqets-distributor-api/revisions/eaf9cf96606a/schema)