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: 

Example response

Seat

{
"C-11": {
"label": "C-11",
"labels": {
"own": {
"label": "11",
"type": "seat"
},
"parent": {
"label": "Row C",
"type": "row"
},
"section": "Section 1"
},
"ids": {
"own": "11",
"parent": "C"
},
"status": "free",
"categoryLabel": "Ground Floor",
"categoryKey": "4",
"entrance": "Main entrance",
"ticketType": "adult",
"section": "Section 1",
"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",
"seasonStatusOverriddenQuantity": 0
}
}

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,
"numNotForeSale": 0,
"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
}
},
"seasonStatusOverriddenQuantity": 0,
"numNotForSale": 0
}
}

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,
"seasonStatusOverriddenQuantity": 0
}
}