Get event status
Returns the list of non-free seat statuses for an event. Seats absent from the response are implicitly `free` (lazy initialization). This is the endpoint the SDK polls to render the live seat map. Pass `?labels=A-12,A-13` to narrow to specific seats (still omits free seats — see /objects for the full layout).
curl -X GET "https://seatbuilder.org/api/v1/events/string/status"{
"eventKey": "evt_q3-2026-jazz-night",
"objects": [
{
"objectLabel": "A-12",
"status": "held",
"holdToken": "7f6c3a91-b1ef-4d0a-9c84-3f12a8e0b5d2",
"holdExpiresAt": "2026-10-02T18:55:00.000Z",
"categoryKey": "premium",
"extraData": {
"orderId": "ord_98a2"
}
},
{
"objectLabel": "A-13",
"status": "booked",
"holdToken": null,
"holdExpiresAt": null,
"categoryKey": "premium",
"extraData": {
"orderId": "ord_98a3"
}
}
]
}{
"statusCode": 0,
"message": "string",
"errors": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}{
"statusCode": 0,
"message": "string",
"errors": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}{
"statusCode": 0,
"message": "string",
"errors": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}{
"statusCode": 0,
"message": "string",
"errors": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}Get event objects GET
Returns the published chart’s objects and category definitions independent of live status (C1). Use it to join each object’s categoryKey to your own data (e.g. pricing) — including for free seats — before they are held. An unpublished chart returns empty arrays (200, not 404). Pass ?labels=A-12,A-13 to narrow the response.
Get event reports GET
Returns aggregate seat counts for an event, grouped by status (totals) and by (status, categoryKey). Useful for dashboards and analytics — for live SDK rendering use `/status` instead.