Offers and sessions can have a limited capacity. When a TicketingOffer has availabilityCheckRequired = true, this means they have a limited quantity available for reservation. The availableQuantity value returned by endpoint GET /v1/ticketing/catalogs/{catalogId}/offers are 'close to real-time' values on which you can rely to build your integration. For example, if you want to display offer's availabilities over a month, we advise you to use those values.
In the case you want to know the real-time availability value of a specific session or offer you can use the API endpoint described below.
All sessions have limited access. To avoid getting an error when calling the POST /v1/booking/reservations/_bulk endpoint, you can call the GET /v1/ticketing/catalogs/{catalogId}/offers/{id}/availability endpoint and check the availableQuantity field in the response.
curl --request GET \
--url https://api.korusticket.com/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/offers/0194ac3f-7bdd-7175-a275-30c865618283/availability \
--header 'accept: application/ld+json' \
--header 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
--header 'Accept-Language: fr'{
"@context": "/contexts/TicketingOfferAvailability",
"@id": "/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/offers/0194ac3f-7bdd-7175-a275-30c865618283/availability",
"@type": "TicketingOfferAvailability",
"availableQuantity": 41301,
"sessionsAvailability": [
{
"@context": "string",
"@id": "string",
"@type": "string",
"session": "/v1/ticketing/catalogs/0194d07e-aa2e-77b1-b68d-92664785a066/events/0194cb3c-a7c7-7d3d-a335-f1b396083acd/sessions/01987481-3906-78d5-80bb-08dce0ce49fd",
"availableQuantity": 4000
}
]
}