The Product Availability Endpoint returns the availability and pricing for all the variants of a product on all days, from the current date up to the end_date.
This endpoint returns a max_orders value for each day, timeslot, and variant_id. This value represents the maximum number of tickets that can be purchased together on an order for that product, variant, and timeslot.
Note the following:
The endpoint response returns a maximum of 31 days per request to manage the response time of the endpoint.
Products can return availability and pricing for up to one year into the future.
If no tickets are available for purchase on a day or timeslot, no day or timeslot is returned.
If a product does not have timeslots, a single timeslot is returned, with the value of `whole_day`.
It is not possible to obtain the raw availability (actual number of tickets).
The returned information is cached and updated frequently. We have processes in place to ensure the data is as fresh as possible, but there may occasionally be a discrepancy between the returned availability and the actual availability.
Product availability and pricing
get
/products/{productId}/availability
Path parameters
productIdintegerRequired
ID of the product to return.
Example: 974092
Query parameters
currencystringOptional
Currency code of the price components (ISO 4217).
Default: EURExample: EUR
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: 2019-06-05Pattern: YYYY-MM-DD
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: 2019-06-05Pattern: YYYY-MM-DD
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.
