SeatBuilderSeatBuilder Docs

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.

GET/api/v1/events/{eventKey}/status

Path Parameters

eventKeystring

Response Body

curl -X GET "http://localhost:3000/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"
    ]
  }
}