Get products calendar

The endpoint returns the availability calendar of the requested products.

The returned information can be used to get a quick overview of availability of a selection of products. For detailed information of available timeslots, variants, and corresponding prices, please refer to the Product availability and pricing endpoint.

Product calendar

get

https://api-tiqt-test.steq.it/v2https://api.tiqets.com/v2

/products/calendar

Query parameters

product_idsstringRequired

List of comma-separated product IDs for which to request the calendar. At least one product ID needs to be provided; the maximum is 20 product IDs.

Example: 1006356,1010393,975854

langstringOptional

Language of the content to retrieve (ISO 639-1). Defaults to English if undefined.

Default: enExample: en

start_datestring · dateOptional

First day for which to return availability.

Example: 2025-03-21

end_datestring · dateOptional

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.

Example: 2025-03-25

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful operation.

application/json

400

Bad Request -- Check your request parameters (typo in parameter or invalid value).

application/json

401

Unauthorized -- Your API key is incorrect.

application/json

403

Forbidden -- The endpoint or parameters are not allowed for the matching API key.

application/json

404

Not Found -- Requested resource/endpoint could not be found.

application/json

405

Method Not Allowed -- Check your request method.

application/json

429

Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.

application/json

500

Internal Server Error -- We had a problem with our server. Try again later.

application/json

503

Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

application/json

get

/products/calendar

HTTPcURLJavaScriptPython

GET /v2/products/calendar?product_ids=1006356%2C1010393%2C975854 HTTP/1.1
Host: api-tiqt-test.steq.it
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "value": {
    "success": true,
    "products": [
      {
        "product_id": 1005201,
        "name": "The Mauritshuis Museum: Entry Ticket",
        "availability": [
          {
            "date": "2025-03-22",
            "available": true
          },
          {
            "date": "2025-03-23",
            "available": true
          }
        ]
      },
      {
        "product_id": 984972,
        "name": "1238 Battle of Iceland: Entry Ticket",
        "availability": [
          {
            "date": "2025-03-22",
            "available": true
          },
          {
            "date\"": "2025-03-23",
            "available": false
          }
        ]
      }
    ]
  }
}