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.
- Text
- PHP
- C#
- Java
- Python
- Ruby
- Javascript
- Go
GET https://api-{region}.seatsio.net/events/{eventKey}/objects?label={objectLabel1}&label={objectLabel2}...
$seatsioClient->events->retrieveObjectInfos("event34", ["C-11", "GA1"]);
Client.Events.RetrieveObjectInfos("event34", new string[] {"C-11", "GA1"});
client.events.retrieveObjectInfos("event34", List.of("C-11", "GA1"));
client.events.retrieve_object_infos("event34", ["C-11", "GA1"])
client.events.retrieve_object_infos key: "event34", labels: ["C-11", "GA1"]
await client.events.retrieveObjectInfos('eventKey', ['C-11', 'GA1']);
info, err := client.Events.RetrieveObjectInfo("eventKey", "C-11", "GA1")
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
}
}