List status changes

Each time the status of an object changes (e.g. by holding, booking or releasing it), a status change is recorded in seats.io. Use the following API call to list the status changes for an event.

Status changes are returned paginated, with the most recent ones first. Response body contains the hold token if a hold token was passed in when doing the status change (e.g. to hold an object, or to release an object that was previously held).

GET https://api-{region}.seatsio.net/events/{eventKey}/status-changes
GET https://api-{region}.seatsio.net/events/{eventKey}/status-changes?filter=A-1
GET https://api-{region}.seatsio.net/events/{eventKey}/status-changes?sort=objectLabel:desc
More info: https://docs.seats.io/docs/api-pagination
  • filter: use this parameter to filter on object labels. E.g. if you pass in 'A-1', all status changes for objects that have 'A-1' in their name will be returned (e.g. 'A-11', 'A-1', 'Section A-A-1').
  • sort: by default, status changes are sorted by date, with the newest status changes coming first. You can change this to sort by object label (sort=objectLabel) or by status (sort=status). Sorting by date with the oldest status changes first is also possible (sort=date:asc)

Example request

curl https://api-{region}.seatsio.net/events/anEvent/status-changes?limit=100&start_after_id=34 \
-u aSecretKey:
{
"next_page_starts_after": 122,
"items": [
{
"id": 169,
"eventId": 12,
"status": "booked",
"quantity": 1,
"objectLabel": "A-1",
"date": "2017-05-05T10:58:44.715Z",
"orderId": "anOrder",
"extraData": {
"userId": "123"
},
"origin": {
"type": "API_CALL",
"ip": "10.4.32.67"
}
},
{
"id": 168,
"eventId": 12,
"status": "reservedByToken",
"quantity": 1,
"objectLabel": "B-1",
"date": "2017-05-05T09:58:44.715Z",
"orderId": "anotherOrder",
"extraData": {
"userId": "456"
},
"holdToken": "wvXbB9MlHt",
"origin": {
"type": "HELD_BY_USER"
}
}
...
]
}

origin can be either API_CALL, HELD_BY_USER, HOLD_RELEASED_BY_USER or HOLD_EXPIRED. An ip property is present when the type equals API_CALL.