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

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

PHP

$seatsioClient->events->retrieveObjectInfos("event34", ["C-11", "GA1"]);

C#

await Client.Events.RetrieveObjectInfosAsync("event34", new string[] {"C-11", "GA1"});

Java

client.events.retrieveObjectInfos("event34", List.of("C-11", "GA1"));

Python

client.events.retrieve_object_infos("event34", ["C-11", "GA1"])

Ruby

client.events.retrieve_object_infos key: "event34", labels: ["C-11", "GA1"]

Javascript

await client.events.retrieveObjectInfos('eventKey', ['C-11', 'GA1']);

Go

info, err := client.Events.RetrieveObjectInfo("eventKey", "C-11", "GA1")

Try it

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,
    "hasLiftUpArmrests": false,
    "isHearingImpaired": false,
    "isSemiAmbulatorySeat": false,
    "hasSignLanguageInterpretation": false,
    "isPlusSize": 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

Note

Objects with objectType generalAdmission are areas. All areas have an areaType, which tells you how they are booked:

• generalAdmission: places within the area are booked individually. The area stays available as long as there's capacity left.
• fixedOccupancy: the area is booked as a whole, for its full capacity.
• variableOccupancy: the area is booked as a whole, but the number of occupied places is chosen by the ticket buyer (between minOccupancy and maxOccupancy).

{
  "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,
    "numNotForSale": 0,
    "bookAsAWhole": true,
    "forSale": true,
    "objectType": "generalAdmission",
    "areaType": "variableOccupancy",
    "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
  }
}

Table

Note

Objects with objectType table have a tableType, which tells you how they are booked:

• bookByTable: the table is booked as a whole, together with all of its seats.
• bookBySeat: the seats at the table are booked individually.
• variableOccupancy: the table is booked as a whole, but the number of occupied seats is chosen by the ticket buyer (between minOccupancy and maxOccupancy).
• generalAdmission: the table has a capacity, and places at the table are booked individually, without picking specific seats.

{
  "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",
    "tableType": "bookBySeat",
    "isAvailable": true,
    "channel": "channel1",
    "distanceToFocalPoint": 82.832,
    "seasonStatusOverriddenQuantity": 0
  }
}