Skip to main content

Retrieve information about objects

Rate limits

This endpoint belongs to the priority lane.

Retrieve information about objects in an event. This includes the category and the status of the objects.

A typical use case is fetching the categories for objects the ticket buyer selected.

GET https://api-{region}.seatsio.net/events/{eventKey}/objects?label={objectLabel1}&label={objectLabel2}...

Example request

curl https://api-{region}.seatsio.net/events/event34/objects?label=C-11&label=GA1 -u aSecretKey: 
Note

Seats.io differentiates between the technical label and displayed label for a bookable object. Changing the former in an active event can cause problems with existing bookings. Instead change displayed label, which is always safe. To learn more, see understanding labels

Example response

Seat

{
"C-11": {
"label": "C-11",
"labels": {
"own": {
"label": "11",
"type": "seat"
},
"parent": {
"label": "Row C",
"type": "row"
},
"section": "Floor"
},
"ids": {
"own": "11",
"parent": "C"
},
"status": "free",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"entrance": "Main entrance",
"ticketType": "adult",
"section": "Floor",
"orderId": "order1",
"forSale": true,
"objectType": "seat",
"isAccessible": true,
"isCompanionSeat": false,
"hasRestrictedView": false,
"leftNeighbour": "C-10",
"rightNeighbour": "C-12",
"isAvailable": true,
"channel": "channel1",
"distanceToFocalPoint": 84.3242,
"holdToken": "98291cfa-5488-456d-a82e-0a699b9e1c8d"
}
}

General admission area

{
"GA1": {
"label": "GA",
"labels": {
"own": {
"label": "General Admission 1",
"type": "generalAdmission"
}
},
"ids": {
"own": "GA"
},
"status": "free",
"categoryLabel": "Standing",
"categoryKey": 6,
"capacity": 100,
"numBooked": 34,
"numHeld": 6,
"numFree": 60,
"bookAsAWhole": false,
"forSale": true,
"objectType": "generalAdmission",
"isAvailable": true,
"channel": "channel1",
"distanceToFocalPoint": 82.832,
"variableOccupancy": true,
"minOccupancy": 5,
"maxOccupancy": 100, // only present if variableOccupancy is true
"holds": {
"98291cfa-5488-456d-a82e-0a699b9e1c8d": {
"adult": 3,
"child": 2
},
"58291cfa-5418-496d-a02e-0a199b9e1c2f": {
"NO_TICKET_TYPE": 1
}
}
}
}

Table

{
"T1": {
"label": "T1",
"labels": {
"own": {
"label": "T1",
"type": "table"
}
},
"ids": {
"own": "T1"
},
"status": "free",
"numSeats": 5,
"bookAsAWhole": false,
"categoryLabel": "Standing",
"categoryKey": 6,
"forSale": true,
"objectType": "table",
"isAvailable": true,
"channel": "channel1",
"distanceToFocalPoint": 82.832
}
}