Offers and sessions can have a limited capacity. When a TicketingOffer has availabilityCheckRequired=true, this means they have a limited quantity available for reservation. When you want to know the real-time availability of and offer and its sessions, 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.demo.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/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/offers/0194ac3f-7bdd-7175-a275-30c865618283/tickets/0199570c-9a82-791e-ab92-88e99b5f159a/sessions/0199570c-9a85-7f53-962a-a8f0a54441cb",
"availableQuantity": 4000
}
]
}