Get seat availability

This endpoint returns the current occupancy of the seats of a show, either as a full snapshot or as the changes since a known history position.

Poll it while the buyer chooses seats. Expired reservations do not produce a change entry, so load a full snapshot (without since) from time to time as well, and apply delta entries per seat in ascending historyId order.

Request

This request does not contain a request body.

• showId (string, path): The ID of the show.

• since (number, query, optional): The head of a previous answer. Without it the answer is a snapshot.

• areaId (string, query, optional): Limits the answer to one area node.

Response

• data (object)

  • showId (string), areaId (string, nullable), isSeatingActive (boolean)

  • head (number): Current history position; pass it as since in the next call.

  • changed (boolean): false when nothing changed since since.

  • mode (string): snapshot lists every seat that is not free (all unlisted seats are free). delta lists the changes after since, possibly several entries for the same seat. A since greater than head answers with a snapshot.

  • seats (array): seatId, availability (free, reserved or booked) and historyId (nullable).