Skip to main content

Event Reports

The Event Report endpoints all give you access to the data about an event.

The Seats.io API provides the following types of reports:

  1. Flat report: returns all bookable objects as a simple array, without any grouping. Also available as CSV.
  2. Detailed reports: these contain details on each and every bookable object, grouped by a report type (e.g. by status, by category, etc.)
  3. Summary reports: these don't contain the individual bookable objects, but give you an aggregated view (e.g. the total number of seats with status "BOOKED").
  4. Deep summary reports: like summary reports, but with an extra level of nesting (e.g. for each status, a breakdown by category).

You can retrieve each of these reports in different representations, which we call report types. For example, the byLabel report will give you an overview of all seats per seat label, whereas the "byStatus" report will give you an overview of all different seat statuses present on the event, together with a list of the seats that have that status.

Important: Do not use these endpoints to check whether a seat is free before trying to book it!

Not only is it unnecessary to pre-check the seat status, it is actually harmful: you will get double bookings if you do so.

Read more on the topic here.