Custom object status

If you need more statuses than just booked and free, you can use this API call to change the status of a seat, table or booth to your own custom status.

POST https://api-{region}.seatsio.net/events/{eventKey}/actions/change-object-status
POST https://api-{region}.seatsio.net/events/{eventKey}/actions/change-object-status?expand=objects
Note

All seats (or tables, booths or GA places) passed in to this API will be considered as "used seats" for pricing purposes.

Request#

// No ticket types
{
'objects': ['A-3', 'A-5'],
'status': 'myCustomStatus'
}
// Ticket types
{
'objects': [
{'objectId': 'A-1', 'ticketType': 'adult'},
{'objectId': 'A-2', 'ticketType': 'child'}
],
'status': 'myCustomStatus'
}
  • objects: an array of object ids to release
  • status: the status you want to assign to an object
  • holdToken (optional): the hold token must be supplied when you want to make sure that the same person that made the hold confirms his booking.
  • orderId (optional): an order id, defined by yourself, to be able to retrieve the objects IDs per order later on.
  • channelKeys (optional): an array of strings, i.e. the channel keys of the channel(s) to which the objects belong. If omitted, and the objects are assigned to a channel, the request will fail with 400 Bad request. Pass in NO_CHANNEL as channel key to allow objects without a channel.
  • ignoreChannels (optional): if true, the status change call succeeds, even if the objects belong to a channel. Useful inside a back office application, in which the user is allowed to book any seat - no matter the channel. Should not be used in combination with channelKeys.
  • ignoreSocialDistancing (optional): if true, social distancing rules are not checked for this status change.

Response#

Without expand=objects 204 - No Content

With expand=objects 200 - ok

{
"A-3": {
"label": "A-3",
"labels": {
"own": {
"label": "3",
"type": "seat"
},
"parent": {
"label": "Row A",
"type": "row"
},
},
"ids": {
"own": "3",
"parent": "A"
},
"status": "myCustomStatus",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"forSale": true,
"objectType": "seat",
"isAccessible": true,
"isCompanionSeat": false,
"hasRestrictedView": false,
"leftNeighbour": "A-2",
"rightNeighbour": "A-4",
"entrance": "Blue"
}
}
{
"T1-3": {
"label": "T1-3",
"labels": {
"own": {
"label": "3",
"type": "seat"
},
"parent": {
"label": "Table T1",
"type": "table"
},
},
"ids": {
"own": "3",
"parent": "T1"
},
"status": "myCustomStatus",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"forSale": true,
"objectType": "seat",
"isAccessible": true,
"isCompanionSeat": false,
"hasRestrictedView": false
}
}
{
"STA-A-3": {
"label": "STA-A-3",
"labels": {
"own": {
"label": "3",
"type": "seat"
},
"parent": {
"label": "Row A",
"type": "row"
},
"section": "Stalls"
},
"ids": {
"own": "3",
"parent": "A",
"section": "STA"
},
"status": "myCustomStatus",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"forSale": true,
"objectType": "seat",
"section": "STA",
"entrance": "Red",
"isAccessible": true,
"isCompanionSeat": false,
"hasRestrictedView": false
}
}
{
"B1": {
"label": "B1",
"labels": {
"own": {
"label": "B1",
"type": "booth"
}
},
"ids": {
"own": "B1"
},
"status": "myCustomStatus",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"forSale": true,
"objectType": "booth"
}
}
{
"T1": {
"label": "T1",
"labels": {
"own": {
"label": "T1",
"type": "table"
}
},
"ids": {
"own": "T1"
},
"status": "myCustomStatus",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"forSale": true,
"objectType": "table"
}
}
{
"GA1": {
"label": "GA1",
"labels": {
"own": {
"label": "General Admission 1",
"type": "generalAdmission"
}
},
"ids": {
"own": "GA1"
},
"status": "myCustomStatus",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"forSale": true,
"objectType": "generalAdmission"
}
}
  • objects: JSON object that contains detailed information about the objects