List status changes for an object

Lists status changes for an object in the event, with the most recent ones first.

We only return status changes that happened in the last 365 days. Older status changes are deleted.

Text

GET https://api-{region}.seatsio.net/events/{eventKey}/objects/{objectLabel}/status-changes

More info: More info: https://docs.seats.io/docs/api-pagination

PHP

$seatsioClient->events->statusChangesForObject(eventKey, objectLabel)->firstPage(pageSize?)
$seatsioClient->events->statusChangesForObject(eventKey, objectLabel)->pageAfter(afterId, pageSize?)
$seatsioClient->events->statusChangesForObject(eventKey, objectLabel)->pageBefore(beforeId, pageSize?)

$seatsioClient->events->statusChangesForObject(eventKey, objectLabel)->all()

/*
Some examples (for charts, but listing status changes works similarly):

https://github.com/seatsio/seatsio-php/blob/master/README.md#listing-charts-page-by-page
https://github.com/seatsio/seatsio-php/blob/master/README.md#listing-all-charts
*/

C#

await client.Events.StatusChangesForObject(eventKey, objectLabel).FirstPageAsync(pageSize?)
await client.Events.StatusChangesForObject(eventKey, objectLabel).PageAfterAsync(afterId, filter?, pageSize?)
await client.Events.StatusChangesForObject(eventKey, objectLabel).PageBeforeAsync(beforeId, filter?, pageSize?)

client.Events.StatusChangesForObject(eventKey, objectLabel).AllAsync(filter?);

/*
Some examples (for charts, but listing status changes works similarly):

https://github.com/seatsio/seatsio-dotnet/blob/master/README.md#listing-charts-page-by-page
https://github.com/seatsio/seatsio-dotnet/blob/master/README.md#listing-all-charts
*/

Java

client.events.statusChangesForObject(eventKey, objectLabel).firstPage(pageSize?)
client.events.statusChanges(eventKey, objectLabel).pageAfter(afterId, pageSize?)
client.events.statusChanges(eventKey, objectLabel).pageBefore(beforeId, pageSize?)

client.events.statusChanges(eventKey, objectLabel).all();

/*
Some examples (for charts, but listing status changes works similarly):

https://github.com/seatsio/seatsio-java/blob/master/README.md#listing-charts-page-by-page
https://github.com/seatsio/seatsio-java/blob/master/README.md#listing-all-charts
*/

Python

client.events.status_changes_for_object(event_key, object_label).first_page(page_size?)
client.events.status_changes_for_object(event_key, object_label).page_after(after_id, page_size?)
client.events.status_changes_for_object(event_key, object_label).page_before(before_id, page_size?)

client.events.status_changes_for_object(event_key, object_label).list()

"""
Some examples (for charts, but listing status changes for an object works similarly):

https://github.com/seatsio/seatsio-python/blob/master/README.md#listing-charts-page-by-page
https://github.com/seatsio/seatsio-python/blob/master/README.md#listing-all-charts
"""

Ruby

client.events.list_status_changes_for_object(event_key, object_label).first_page(page_size?)
client.events.list_status_changes_for_object(event_key, object_label).page_after(after_id, page_size?)
client.events.list_status_changes_for_object(event_key, object_label).page_before(before_id, page_size?)

client.events.list_status_changes_for_object(event_key, object_label)
  
# Some examples (for charts, but listing status changes for an object works similarly):

# https://github.com/seatsio/seatsio-ruby/blob/master/README.md#listing-charts-page-by-page
# https://github.com/seatsio/seatsio-ruby/blob/master/README.md#listing-all-charts

Javascript

for await (let statusChange of client.events.statusChangesForObject(eventKey, objectLabel).all()) {
	//Do something with the status changes
}

client.events.statusChangesForObject(eventKey, objectLabel).firstPage(pageSize?)
client.events.statusChangesForObject(eventKey, objectLabel).pageAfter(afterId, pageSize?)
client.events.statusChangesForObject(eventKey, objectLabel).pagBefore(beforeId, pageSize?)

/*
Some examples (for charts, but listing status changes for an object works similarly):

https://github.com/seatsio/seatsio-java/blob/master/README.md#listing-charts-page-by-page
https://github.com/seatsio/seatsio-java/blob/master/README.md#listing-all-charts
*/

Go

statusChanges, err := client.Events.StatusChangesForObject(eventKey, objectLabel).All(<optional pagination params>)

statusChanges, err := client.Events.StatusChangesForObject(eventKey, objectLabel).ListFirstPage(<optional pagination params>)
 
statusChanges, err := client.Events.StatusChangesForObject(eventKey, objectLabel).ListPageAfter(afterId, <optional pagination params>)

statusChanges, err := client.Events.StatusChangesForObject(eventKey, objectLabel).ListPageBefore(beforeId, <optional pagination params>)

/*
Some examples (for charts, but listing status changes for an object works similarly):

https://github.com/seatsio/seatsio-java/blob/master/README.md#listing-charts-page-by-page
https://github.com/seatsio/seatsio-java/blob/master/README.md#listing-all-charts
*/

curl https://api-{region}.seatsio.net/events/event34/objects/A-1/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"
            },
            "isPresentOnChart": true
        },
        {
            "id": 168,
            "eventId": 12,
            "status": "free",
            "quantity": 1,
            "objectLabel": "A-1",
            "date": "2017-05-05T09:58:44.715Z",
            "orderId": "anotherOrder",
            "extraData": {
                "userId": "456"
            },
            "origin": {
              "type": "HELD_BY_USER"
            },
            "isPresentOnChart": false,
            "notPresentOnChartReason": "RENAMED_OR_DELETED"
        }
        ...
    ]
}

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.

isPresentOnChart indicates whether the object of the status change still exists on the chart, as a bookable object. E.g. a seat might still exist, but if its table is now bookable as a whole it's not bookable anymore.

If isPresentOnChart is false, notPresentOnChartReason is set to either:

• RENAMED_OR_DELETED
• SWITCHED_TO_BOOK_WHOLE_TABLE: the table seat was bookable, but now the table is bookable as a whole
• SWITCHED_TO_BOOK_BY_SEAT: the table was bookable as a whole, but is now bookable by seat