Retrieve an event

Rate limits

This endpoint does not belong to the priority lane. Do not use it within your ticket sales flow.

Retrieve an event

Text

GET https://api-{region}.seatsio.net/events/{eventKey}

PHP

$seatsioClient->events->retrieve("anotherEvent");

C#

await Client.Events.RetrieveAsync("anotherEvent");

Java

client.events.retrieve("anotherEvent");

Python

client.events.retrieve("anotherEvent")

Ruby

client.events.retrieve key: "anotherEvent"

Javascript

await client.events.retrieve('eventKey');

Go

event, _ := client.Events.Retrieve(event.Key)

curl https://api-{region}.seatsio.net/events/anEvent -u aSecretKey: 

{
    "id": 168,
    "key": "anotherEvent",
    "tableBookingConfig": {
      "mode": "CUSTOM",
      "tables": {
      	"T1": "BY_TABLE",
      	"T2": "BY_SEAT",
      	"T3": "BY_TABLE"
      }
    },
    "chartKey": "4150dddc-e41f-c7cb-986a-2c5e728b8c20",
    "supportsBestAvailable": true,
    "forSaleConfig": {
        "forSale": false,
        "objects": ["section1"],
        "categories": []
    },
    "channels": [
      {
        "name": "Channel 1",
        "key": "8950dddc-e51f-c7cb-986a-2c5e728b8c21",
        "color": "#aaaaaa",
        "objects": ["A-1", "A-2"]
      }
    ],
    "categories": [
      { "key": 1, "label": "Category 1", "color": "#aaaaaa", "accessible": true},
      { "key": 2, "label": "Category 2", "color": "#bbbbbb", "accessible":  false}
    ],
    "isSeason": false,
    "isTopLevelSeason": false,
    "isPartialSeason": false,
    "isEventInSeason": false,
    "createdOn": "2017-03-05T10:58:44.715Z",
    "updatedOn": "2017-04-05T10:58:44.615Z",
    "isInThePast": false
}

• supportsBestAvailable: true if the chart of the event has a focal point.

• forSaleConfig: null, unless /mark-as-for-sale or /mark-as-not-for-sale have been called

• tableBookingConfig: mode can either be

  • INHERIT: table booking settings are inherited from the chart
  • CUSTOM: for this event, some tables have a different table booking config than defined on the chart
  • ALL_BY_SEAT: for this event, all tables are bookable by seat
  • ALL_BY_TABLE: for this event, all tables are bookable as a whole

• tableBookingModes: deprecated. Use tableBookingConfig.tables instead.

• bookWholeTables: deprecated. Use tableBookingConfig.mode instead.

• categories: list of categories defined on the chart linked to the event

• partialSeasonKeysForEvent: list of partial seasons the event belongs to. Not present if the event is not part of a season.

When the returned event is a season, it has some extra keys:

• events: array of events for the season

• partialSeasonKeys: array of partial season keys for the season

• isInThePast: Indicates if an event has been marked as in the past. This is only applicable for events in a season