Detailed event reports

Rate limits

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

Want to know which seats of an event are booked, and which ones are free? That’s where our detailed reporting API calls come in handy.

GET /reports/events/{eventKey}/{reportType}

The report types you can choose from are:

• byAvailabilityReason
• byAvailability
• byStatus
• byCategoryLabel
• byCategoryKey
• byLabel
• byOrderId
• bySection
• byChannel
• byObjectType
• byZone

You can also pass in an optional filter, for example to retrieve only the objects in a certain status:

GET /reports/events/{eventKey}/{reportType}/{filter}

E.g. /reports/events/event34/byStatus/booked

Note

Keep in mind that certain characters need to be URI encoded!

Note

The possible values for objectType are:

• seat
• table
• generalAdmission
• booth

Most properties in the responses should be self-explanatory. However, ids and labels deserve some attention.

labels contains the displayed label for the object, its parent row or table, and its section. In most cases, the 'technical' label (aka the ID) of an object is the same as its display label. But if needed, you can set a different display label in the designer.

ids contains the technical labels, by which objects are identified (e.g. when booking them).

Limiting the scope of season reports

By default, reports for seasons and partial seasons include objects that have been booked directly on events in the season as well as at the season level. The same is true for reports of events in a season - they contain both bookings at the season level and objects booked directly on them.

If you want a season report to only include objects booked at the season level, you can add a query parameter seasonBookingsPropagated to limit the scope, e.g. /reports/events/season34/byStatus/booked?seasonBookingsPropagated=false. This can be applied to any season, partial season, or an event in a season.

In an example in which a season has 400 bookings at the top-level season level, and 50 bookings directly on one of the events, the report would change depending on if you use the seasonBookingsPropagated query parameter.

Value	Target	Number of bookings
Omitted	Top-level season	450
Omitted	Event in season	450
false	Top-level season	400
false	Event in season	50

Text

GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byAvailabilityReason?seasonBookingsPropagated=false

PHP

$withoutPropagation = $this->seatsioClient->eventReports->withSeasonBookingsNotPropagated();
$withoutPropagation->byAvailabilityReason("season34");
$withoutPropagation->byAvailabilityReason("season34", "available");
$withoutPropagation->byAvailabilityReason("eventInSeason34", "booked");

C#

var withoutPropagation = Client.EventReports.WithSeasonBookingsNotPropagated();
await withoutPropagation.ByAvailabilityReasonAsync("season34");
await withoutPropagation.ByAvailabilityReasonAsync("season34", "available");
await withoutPropagation.ByAvailabilityReasonAsync("eventInSeason34", "booked");

Java

EventReports withoutPropagation = client.eventReports.withSeasonBookingsNotPropagated();
withoutPropagation.byAvailabilityReason("season34");
withoutPropagation.byAvailabilityReason("season34", "available");
withoutPropagation.byAvailabilityReason("eventInSeason34", "booked");

Python

without_propagation = self.client.events.reports.with_season_bookings_not_propagated()
without_propagation.by_availability_reason("season34")
without_propagation.by_availability_reason("season34", status="available")
without_propagation.by_availability_reason("eventInSeason34", status="booked")

Ruby

without_propagation = @seatsio.event_reports.with_season_bookings_not_propagated
without_propagation.by_availability_reason("season34")
without_propagation.by_availability_reason("season34", "available")
without_propagation.by_availability_reason("eventInSeason34", "booked")

Javascript

const withoutPropagation = client.eventReports.withSeasonBookingsNotPropagated()
await withoutPropagation.byAvailabilityReason('season34');
await withoutPropagation.byAvailabilityReason('season34', 'available');
await withoutPropagation.byAvailabilityReason('eventInSeason34', 'booked');

Go

withoutPropagation := client.EventReports.WithSeasonBookingsNotPropagated()
report, err := withoutPropagation.ByAvailabilityReason("season34")
items, err := withoutPropagation.BySpecificAvailabilityReason("season34", reports.Available)
items, err := withoutPropagation.BySpecificAvailabilityReason("eventInSeason34", reports.Booked)

Detailed report by availability reason

This report allows you to figure out how many objects are still available, and how many are not - including the reason why they're not available.

That reason can be:

• available (object is available, i.e. it's selectable for ticket buyers)
• booked (object is booked)
• reservedByToken (object is held)
• not_for_sale (object is marked as not for sale)
• a custom status (object is assigned a custom status)

Objects that have a non-free status AND are marked as not for sale get that custom status as availability reason (instead of not_for_sale).

Text

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

PHP

$seatsioClient->eventReports->byAvailabilityReason("event34");
$seatsioClient->eventReports->byAvailabilityReason("event34", "available");
$seatsioClient->eventReports->byAvailabilityReason("event34", "booked");

C#

await Client.EventReports.ByAvailabilityReasonAsync("event34");
await Client.EventReports.ByAvailabilityReasonAsync("event34", "available");
await Client.EventReports.ByAvailabilityReasonAsync("event34", "booked");

Java

client.eventReports.byAvailabilityReason("event34");
client.eventReports.byAvailabilityReason("event34", "available");
client.eventReports.byAvailabilityReason("event34", "booked");

Python

client.events.reports.by_availability_reason("event34")
client.events.reports.by_availability_reason("event34", status="available")
client.events.reports.by_availability_reason("event34", status="booked")

Ruby

client.event_reports.by_availability_reason("event34")
client.event_reports.by_availability_reason("event34", "available")
client.event_reports.by_availability_reason("event34", "booked")

Javascript

await client.eventReports.byAvailabilityReason('eventKey');
await client.eventReports.byAvailabilityReason('eventKey', 'available');
await client.eventReports.byAvailabilityReason('eventKey', 'booked');

Go

report, err := client.EventReports.ByAvailabilityReason("event34")
items, err := client.EventReports.BySpecificAvailabilityReason("event34", reports.Available)
items, err := client.EventReports.BySpecificAvailabilityReason("event34", reports.Booked)

curl https://api-{region}.seatsio.net/reports/events/event34/byAvailabilityReason -u aSecretKey: 

{
    "available": [
        {
            "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,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "booked": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "reservedByToken": [
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "holdToken": "wvXbB9MlHt",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour":category "C-36",
            "isAvailable": false,
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "not_for_sale": []
}

Detailed report by availability

This report allows you to distinguish between available and non-available objects. An object is considered available if:

• Its status equals free
• It's for sale: forSale: true

Text

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

PHP

$seatsioClient->eventReports->byAvailability("event34");
$seatsioClient->eventReports->byAvailability("event34", "available");
$seatsioClient->eventReports->byAvailability("event34", "not_available");

C#

await Client.EventReports.ByAvailabilityAsync("event34");
await Client.EventReports.ByAvailabilityAsync("event34", "available");
await Client.EventReports.ByAvailabilityAsync("event34", "not_available");

Java

client.eventReports.byAvailability("event34");
client.eventReports.byAvailability("event34", "available");
client.eventReports.byAvailability("event34", "not_available");

Python

client.events.reports.by_availability("event34")
client.events.reports.by_availability("event34", status="available")
client.events.reports.by_availability("event34", status="not_available")

Ruby

client.event_reports.by_availability("event34")
client.event_reports.by_availability("event34", "available")
client.event_reports.by_availability("event34", "not_available")

Javascript

await client.eventReports.byAvailability('eventKey');
await client.eventReports.byAvailability('eventKey', 'available');
await client.eventReports.byAvailability('eventKey', 'not_available');

Go

report, err := client.EventReports.ByAvailability("event34")
items, err := client.EventReports.BySpecificAvailability("event34", reports.Available)
items, err := client.EventReports.BySpecificAvailability("event34", reports.NotAvailable)

curl https://api-{region}.seatsio.net/reports/events/event34/byAvailability -u aSecretKey: 

{
    "available": [
        {
            "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",
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "not_available": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "holdToken": "wvXbB9MlHt",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "availabilityReason": "reservedByToken",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ]
}

Detailed report by status

info

Most likely you'll want to use the detailed report by availability reason instead of the one by status.

The availability reason gives detailed info on why an object is not available: either because it has a non-free status, or because it's not for sale. In the report by status, objects that are not for sale are considered free (since technically that is their status).

Text

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

PHP

$seatsioClient->eventReports->byStatus("event34");
$seatsioClient->eventReports->byStatus("event34", "booked");

C#

await Client.EventReports.ByStatusAsync("event34");
await Client.EventReports.ByStatusAsync("event34", "booked");

Java

client.eventReports.byStatus("event34");
client.eventReports.byStatus("event34", "booked");

Python

client.events.reports.by_status("event34")
client.events.reports.by_status("event34", status="booked")

Ruby

client.event_reports.by_status("event34")
client.event_reports.by_status("event34", "booked")

Javascript

await client.eventReports.byStatus('eventKey');
await client.eventReports.byStatus('eventKey', 'booked');

Go

report, err := client.EventReports.ByStatus("eventKey")
items, err := client.EventReports.BySpecificStatus("eventKey", reports.Booked)

curl https://api-{region}.seatsio.net/reports/events/event34/byStatus -u aSecretKey: 

{
    "free": [
        {
            "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,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "booked": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "reservedByToken": [
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "holdToken": "wvXbB9MlHt",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ]
}

Detailed report by category label

Text

GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byCategoryLabel
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byCategoryLabel/{categoryLabel}
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byCategoryLabel/NO_CATEGORY

PHP

$seatsioClient->eventReports->byCategoryLabel("event34");
$seatsioClient->eventReports->byCategoryLabel("event34", "cat1");
$seatsioClient->eventReports->byCategoryLabel("event34", "NO_CATEGORY");

C#

await Client.EventReports.ByCategoryLabelAsync("event34");
await Client.EventReports.ByCategoryLabelAsync("event34", "cat1");
await Client.EventReports.ByCategoryLabelAsync("event34", "NO_CATEGORY");

Java

client.eventReports.byCategoryLabel("event34");
client.eventReports.byCategoryLabel("event34", "cat1");
client.eventReports.byCategoryLabel("event34", "NO_CATEGORY");

Python

client.events.reports.by_category_label("event34")
client.events.reports.by_category_label("event34", "category1")
client.events.reports.by_category_label("event34", "NO_CATEGORY")

Ruby

client.event_reports.by_category_label("event34")
client.event_reports.by_category_label("event34", "category1")
client.event_reports.by_category_label("event34", "NO_CATEGORY")

Javascript

await client.eventReports.byCategoryLabel('eventKey');
await client.eventReports.byCategoryLabel('eventKey', 'Cat1');
await client.eventReports.byCategoryLabel('eventKey', 'NO_CATEGORY');

Go

report, err := client.EventReports.ByCategoryLabel("eventKey")
items, err := client.EventReports.BySpecificCategoryLabel("eventKey", "Cat1")
items, err := client.EventReports.BySpecificCategoryLabel("eventKey", reports.NoCategory)

curl https://api-{region}.seatsio.net/reports/events/event34/byCategoryLabel -u aSecretKey: 

{
    "Ground Floor": [
        {
            "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,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "Balcony": [
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "holdToken": "wvXbB9MlHt",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "Standing": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_CATEGORY": [ ... ]
}

Detailed report by category key

Text

GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byCategoryKey
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byCategoryKey/{categoryKey}
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byCategoryKey/NO_CATEGORY

PHP

$seatsioClient->eventReports->byCategoryKey("event34");
$seatsioClient->eventReports->byCategoryKey("event34", "4");
$seatsioClient->eventReports->byCategoryKey("event34", "NO_CATEGORY");

C#

await Client.EventReports.ByCategoryKeyAsync("event34");
await Client.EventReports.ByCategoryKeyAsync("event34", "4");
await Client.EventReports.ByCategoryKeyAsync("event34", "NO_CATEGORY");

Java

client.eventReports.byCategoryKey("event34");
client.eventReports.byCategoryKey("event34", "4");
client.eventReports.byCategoryKey("event34", "NO_CATEGORY");

Python

client.events.reports.by_category_key("event34")
client.events.reports.by_category_key("event34", "4")
client.events.reports.by_category_key("event34", "NO_CATEGORY")

Ruby

client.event_reports.by_category_key("event34")
client.event_reports.by_category_key("event34", "4")
client.event_reports.by_category_key("event34", "NO_CATEGORY")

Javascript

await client.eventReports.byCategoryKey('eventKey');
await client.eventReports.byCategoryKey('eventKey', '9');
await client.eventReports.byCategoryKey('eventKey', 'NO_CATEGORY');

Go

report, err := client.EventReports.ByCategoryKey("eventKey")
items, err := client.EventReports.BySpecificCategoryKey("eventKey", "9")
items, err := client.EventReports.BySpecificCategoryKey("eventKey", reports.NoCategory)

curl https://api-{region}.seatsio.net/reports/events/event34/byCategoryKey -u aSecretKey: 

{
    "4": [
        {
            "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,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "5": [
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "holdToken": "wvXbB9MlHt",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "6": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_CATEGORY": [ ... ]
}

Detailed report by label

Note

This API call generates a report for all objects or for a single object. To return information on multiple objects, use this one.

Text

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

PHP

$seatsioClient->eventReports->byLabel("event34");
$seatsioClient->eventReports->byLabel("event34", "C-11");

C#

await Client.EventReports.ByLabelAsync("event34");
await Client.EventReports.ByLabelAsync("event34", "C-11");

Java

client.eventReports.byLabel("event34");
client.eventReports.byLabel("event34", "C-11");

Python

client.events.reports.by_label("event34")
client.events.reports.by_label("event34", "C-11")

Ruby

client.event_reports.by_label("event34")
client.event_reports.by_label("event34", "C-11")

Javascript

await client.eventReports.byLabel('eventKey');
await client.eventReports.byLabel('eventKey', 'A-1');

Go

report, err := client.EventReports.ByLabel("eventKey")
items, err := client.EventReports.BySpecificLabel("eventKey", "A-1")

Multiple objects could have the same label, that's why they're returned as an array.

curl https://api-{region}.seatsio.net/reports/events/event34/byLabel -u aSecretKey: 

{
    "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": "1",
            "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,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "C-35": [
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "holdToken": "wvXbB9MlHt",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "C-45": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "2",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "GA": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ]
}

Detailed report by order id

Text

GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byOrderId
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byOrderId/{orderId}
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byOrderId/NO_ORDER_ID

PHP

$seatsioClient->eventReports->byOrderId("event34");
$seatsioClient->eventReports->byOrderId("event34", "order1");
$seatsioClient->eventReports->byOrderId("event34", "NO_ORDER_ID");

C#

await Client.EventReports.ByOrderIdAsync("event34");
await Client.EventReports.ByOrderIdAsync("event34", "order1");
await Client.EventReports.ByOrderIdAsync("event34", "NO_ORDER_ID");

Java

client.eventReports.byOrderId("event34");
client.eventReports.byOrderId("event34", "order1");
client.eventReports.byOrderId("event34", "NO_ORDER_ID");

Python

client.events.reports.by_order_id("event34")
client.events.reports.by_order_id("event34", "order1")
client.events.reports.by_order_id("event34", "NO_ORDER_ID")

Ruby

client.event_reports.by_order_id("event34")
client.event_reports.by_order_id("event34", "order1")
client.event_reports.by_order_id("event34", "NO_ORDER_ID")

Javascript

let report = await client.eventReports.byOrderId('eventKey');
let report = await client.eventReports.byOrderId('eventKey', 'order1');
let report = await client.eventReports.byOrderId('eventKey', 'NO_ORDER_ID');

Go

report, err := client.EventReports.ByOrderId(event.Key)
items, err := client.EventReports.BySpecificOrderId("eventKey", "order1")
items, err := client.EventReports.BySpecificOrderId("eventKey", reports.NoOrderId)

curl https://api-{region}.seatsio.net/reports/events/event34/byOrderId -u aSecretKey: 

{
    "order1": [
        {
            "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": "1",
            "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,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "orderId": "order1",
            "holdToken": "wvXbB9MlHt",
            "forSale": true   ,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "order2": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "2",
            "orderId": "order2",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_ORDER_ID": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_ORDER_ID": [ ... ]
}

Detailed report by section

Text

GET https://api-{region}.seatsio.net/reports/events/{eventKey}/bySection
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/bySection/{section}
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/bySection/NO_SECTION

PHP

$seatsioClient->eventReports->bySection("event34");
$seatsioClient->eventReports->bySection("event34", "Section 1");
$seatsioClient->eventReports->bySection("event34", "NO_SECTION");

C#

await Client.EventReports.BySectionAsync("event34");
await Client.EventReports.BySectionAsync("event34", "Section 1");
await Client.EventReports.BySectionAsync("event34", "NO_SECTION");

Java

client.eventReports.bySection("event34");
client.eventReports.bySection("event34", "Section 1");
client.eventReports.bySection("event34", "NO_SECTION");

Python

client.events.reports.by_section("event34")
client.events.reports.by_section("event34", "Section 1")
client.events.reports.by_section("event34", "NO_SECTION")

Ruby

client.event_reports.by_section("event34")
client.event_reports.by_section("event34", "Section 1")
client.event_reports.by_section("event34", "NO_SECTION")

Javascript

await client.eventReports.bySection('eventKey');
await client.eventReports.bySection('eventKey', 'Floor');
await client.eventReports.bySection('eventKey', 'NO_SECTION');

Go

report, err := client.EventReports.BySection("eventKey")
items, err := client.EventReports.BySpecificSection("eventKey", "Section 1")
items, err := client.EventReports.BySpecificSection("eventKey", reports.NoSection)

curl https://api-{region}.seatsio.net/reports/events/event34/bySection -u aSecretKey: 

{
    "Floor": [
        {
            "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": "1",
            "entrance": "Main entrance",
            "ticketType": "adult",
            "section": "Section 1",
            "forSale": true,
            "orderId": "order1",
            "objectType": "seat",
            "leftNeighbour": "C-10",
            "rightNeighbour": "C-12",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
                "section": "Section 1"
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "section": "Section 1",
            "forSale": true,
            "orderId": "order1",
            "holdToken": "wvXbB9MlHt",
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "Balcony": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
                "section": "Balcony"
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "2",
            "section": "Balcony",
            "forSale": true,
            "orderId": "order2",
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_SECTION": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_SECTION": [ ... ]
}

Detailed report by channel

Text

GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byChannel
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byChannel/{channel}
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byChannel/NO_CHANNEL

PHP

seatsioClient->eventReports->byChannel("eventKey");
seatsioClient->eventReports->byChannel("eventKey", "channel1");
seatsioClient->eventReports->byChannel("eventKey", "NO_CHANNEL");

C#

await Client.EventReports.ByChannelAsync("eventKey");
await Client.EventReports.ByChannelAsync("eventKey", "channelKey1");
await Client.EventReports.ByChannelAsync("eventKey", EventObjectInfo.NoChannel);

Java

Map<String, List<EventObjectInfo>> report = client.eventReports.byChannel("eventKey");
List<EventObjectInfo> report = client.eventReports.byChannel("eventKey", "channel1");
List<EventObjectInfo> report = client.eventReports.byChannel("eventKey", EventObjectInfo.NO_CHANNEL);

Python

client.events.reports.by_channel("eventKey")
client.events.reports.by_channel("eventKey", "channelKey1")
client.events.reports.by_channel("eventKey", "NO_CHANNEL")

Ruby

client.event_reports.by_channel('eventKey')
client.event_reports.by_channel('eventKey', 'channel1')
client.event_reports.by_channel('eventKey', 'NO_CHANNEL')

Javascript

await client.eventReports.byChannel('eventKey')
await client.eventReports.byChannel('eventKey', 'channel1')
await client.eventReports.byChannel('eventKey', 'NO_CHANNEL')

Go

report, err := client.EventReports.ByChannel("eventKey")
items, err := client.EventReports.BySpecificChannel("eventKey", "channel1")
items, err := client.EventReports.BySpecificChannel("eventKey", reports.NoChannel)

curl https://api-{region}.seatsio.net/reports/events/event34/byChannel -u aSecretKey: 

{
    "channel1": [
        {
            "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": "1",
            "entrance": "Main entrance",
            "ticketType": "adult",
            "section": "Section 1",
            "forSale": true,
            "orderId": "order1",
            "objectType": "seat",
            "leftNeighbour": "C-10",
            "rightNeighbour": "C-12",
            "isAvailable": true,
            "availabilityReason": "available",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
                "section": "Section 1"
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "section": "Section 1",
            "forSale": true,
            "orderId": "order1",
            "holdToken": "wvXbB9MlHt",
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "channel2": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
                "section": "Balcony"
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "2",
            "section": "Balcony",
            "forSale": true,
            "orderId": "order2",
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_CHANNEL": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_CHANNEL": [ ... ]
}

Detailed report by object type

Text

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

PHP

$seatsioClient->eventReports->byObjectType("event34");
$seatsioClient->eventReports->byObjectType("event34", "generalAdmission");

C#

await Client.EventReports.ByObjectTypeAsync("event34");
await Client.EventReports.ByObjectTypeAsync("event34", "generalAdmission");

Java

client.eventReports.byObjectType("event34");
client.eventReports.byObjectType("event34", "generalAdmission");

Python

client.events.reports.by_object_type("event34")
client.events.reports.by_object_type("event34", object_type="generalAdmission")

Ruby

client.event_reports.by_object_type("event34")
client.event_reports.by_object_type("event34", "generalAdmission")

Javascript

await client.eventReports.byObjectType('eventKey');
await client.eventReports.byObjectType('eventKey', 'generalAdmission');

Go

report, err := client.EventReports.ByObjectType("eventKey")
items, err := client.EventReports.BySpecificObjectType("eventKey", "generalAdmission")

curl https://api-{region}.seatsio.net/reports/events/event34/byObjectType -u aSecretKey: 

{
    "seat": [
        {
            "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,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245, 
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" }
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "holdToken": "wvXbB9MlHt",
            "forSale": true,
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "generalAdmission": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "table": [],
    "booth": []
}

Detailed report by zone

Text

GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byZone
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byZone/{zone}
GET https://api-{region}.seatsio.net/reports/events/{eventKey}/byZone/NO_ZONE

PHP

$seatsioClient->eventReports->byZone("event34");
$seatsioClient->eventReports->byZone("event34", "Zone 1");
$seatsioClient->eventReports->byZone("event34", "NO_ZONE");

C#

await Client.EventReports.ByZoneAsync("event34");
await Client.EventReports.ByZoneAsync("event34", "Zone 1");
await Client.EventReports.ByZoneAsync("event34", "NO_ZONE");

Java

client.eventReports.byZone("event34");
client.eventReports.byZone("event34", "Zone 1");
client.eventReports.byZone("event34", "NO_ZONE");

Python

client.events.reports.by_zone("event34")
client.events.reports.by_zone("event34", "Zone 1")
client.events.reports.by_zone("event34", "NO_ZONE")

Ruby

client.event_reports.by_zone("event34")
client.event_reports.by_zone("event34", "Zone 1")
client.event_reports.by_zone("event34", "NO_ZONE")

Javascript

await client.eventReports.byZone('eventKey');
await client.eventReports.byZone('eventKey', 'Zone 1');
await client.eventReports.byZone('eventKey', 'NO_ZONE');

Go

report, err := client.EventReports.ByZone("eventKey")
items, err := client.EventReports.BySpecificZone("eventKey", "Zone 1")
items, err := client.EventReports.BySpecificZone("eventKey", reports.NoZone)

curl https://api-{region}.seatsio.net/reports/events/event34/byZone -u aSecretKey: 

{
    "Zone 1": [
        {
            "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": "1",
            "entrance": "Main entrance",
            "ticketType": "adult",
            "section": "Section 1",
            "forSale": true,
            "orderId": "order1",
            "objectType": "seat",
            "leftNeighbour": "C-10",
            "rightNeighbour": "C-12",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 84.3242,
            "seasonStatusOverriddenQuantity": 0,
            "zone": "Zone 1",
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        },
        {
            "label": "C-35",
            "labels": {
                "own": { "label": "35", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
                "section": "Section 1"
            },
            "ids": {
              "own": "35",
              "parent": "C"
            },
            "status": "reservedByToken",
            "categoryLabel": "Balcony",
            "categoryKey": "5",
            "extraData": {"userId": "123"},
            "section": "Section 1",
            "forSale": true,
            "orderId": "order1",
            "holdToken": "wvXbB9MlHt",
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-34",
            "rightNeighbour": "C-36",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 62.923,
            "seasonStatusOverriddenQuantity": 0,
            "zone": "Zone 1",
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "Zone 2": [
        {
            "label": "C-45",
            "labels": {
                "own": { "label": "45", "type": "seat" },
                "parent": { "label": "Row C", "type": "row" },
                "section": "Balcony"
            },
            "ids": {
              "own": "45",
              "parent": "C"
            },
            "status": "booked",
            "categoryLabel": "Balcony",
            "categoryKey": "2",
            "section": "Balcony",
            "forSale": true,
            "orderId": "order2",
            "objectType": "seat",
            "isAccessible": true,
            "isCompanionSeat": false,
            "hasLiftUpArmrests": false,
            "isHearingImpaired": false,
            "isSemiAmbulatorySeat": false,
            "hasSignLanguageInterpretation": false,
            "isPlusSize": false,
            "hasRestrictedView": false,
            "leftNeighbour": "C-46",
            "rightNeighbour": "C-44",
            "isAvailable": false,
            "availabilityReason": "booked",
            "channel": "channel1",
            "distanceToFocalPoint": 10.3245,
            "seasonStatusOverriddenQuantity": 0,
            "zone": "Zone 2",
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_ZONE": [
        {
            "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,
            "forSale": true,
            "objectType": "generalAdmission",
            "isAvailable": true,
            "availabilityReason": "available",
            "channel": "channel1",
            "distanceToFocalPoint": 82.832,
            "variableOccupancy": true,
            "minOccupancy": 5,
            "maxOccupancy": 100 // only present if variableOccupancy is true,
            "seasonStatusOverriddenQuantity": 0,
            "numNotForSale": 0,
            "floor": {
              "name": "1",
              "displayName": "Ground Floor"
            }
        }
    ],
    "NO_ZONE": [ ... ]
}