Making a large number of API requests at once can negatively impact the performance of your website. We strongly recommend caching these calls server-side to avoid browser slow-down and rate limiting.
The Spektrix API can retrieve availability status for event instances. This information can be used to build conditional booking links that show 'limited availability' and 'sold out' messages where appropriate, dynamic calendar listings, and other similar applications.
Detailed Reserved Seat Status
For details on making queries for Event and Instances call please look through our guide to Filtering Events
Since reserved seating plan status data for instances could very large because venues can contain many seats the Spektrix API defines it's own, efficient format for availability data as follows:
The content format is in EBNF
The response will return data in the below structure, line by line;
seatstatus : pricebandid : seatid ,seatid ,seatid ...
Depending on the method of authentication, the response seatstatus characters will return as follows:
A = Available B = In basket U = Unavailable W = Wheelchair locked, available for purchase (Agent) X = Locked, available for purchase (Agent) E = Unavailable (in another basket) (Owner) SC = Scanned (Owner) SO = Sold (Owner) R = Reserved (Owner) L = Locked (Owner) M = Masked (Owner) I = Seat information
Unreserved Instance Status / Status Summary
This call will retrieve the latest seat availability status for events. This can be used for unreserved instances as well as a summary of reserved instances when you don't need the level of detail provided in the previous section.
"name": "Unreserved Example",