Events API

Read your organisation's events, their dates, and their ticket categories. List and retrieve events with their type, currency, timezone and ticketing flags.

Events are the top of the data tree. From an event you reach its dates, its ticket categories, and (via dates) its orders. All endpoints require the read scope and only ever return events belonging to your key's organisation.

Method	Path	Returns
GET	`/v1/events`	A paginated list of your events, most recent first.
GET	`/v1/events/{id}`	A single event.
GET	`/v1/events/{id}/dates`	A paginated list of the event's dates.
GET	`/v1/events/{id}/ticket-categories`	A paginated list of the event's ticket categories.

List events

curl "https://developer.seaty.co.uk/v1/events?per_page=20" \
  -H "Authorization: Bearer sk_live_your_key_here"

Each event in data has these fields:

Field	Type	Description
`id`	integer	The event's numeric id. Use it with the other endpoints.
`tag`	string	The event's URL slug.
`name`	string	The event name.
`organisation_id`	integer	Your organisation's id.
`type`	string \| null	The event type.
`description`	string \| null	The event description.
`date_created`	string \| null	When the event was created (ISO 8601).
`time_zone_id`	string \| null	The event's timezone.
`venue_id`	integer \| null	The linked venue, if any.
`tour_id`	integer \| null	The linked tour, if any.
`currency_symbol`	string \| null	The display symbol, for example `£`.
`unlisted`	boolean \| null	Whether the event is hidden from listings.
`private`	boolean \| null	Whether the event is private.
`ticketing_enabled`	boolean \| null	Whether ticketing is on.
`buying_enabled`	boolean \| null	Whether buying is currently open.

Get one event

curl "https://developer.seaty.co.uk/v1/events/1024" \
  -H "Authorization: Bearer sk_live_your_key_here"

Returns the same fields as the list, for a single event, with no envelope. Returns 404 not_found if the event is not in your organisation.

List an event's dates

curl "https://developer.seaty.co.uk/v1/events/1024/dates" \
  -H "Authorization: Bearer sk_live_your_key_here"

Each date has:

Field	Type	Description
`id`	integer	The date's id. Use it with the Dates endpoints.
`event_id`	integer	The parent event id.
`date`	string	Start date and time (ISO 8601).
`end_date`	string \| null	End date and time, if set.
`time_type`	integer	How the time is interpreted.
`name`	string \| null	An optional name for the performance.
`sold_out`	boolean \| null	Whether the date is sold out.
`suspend`	boolean \| null	Whether sales are suspended.

List an event's ticket categories

This is the reference data behind the ticket_category_id you see on order tickets. Join the two to turn an id into a name and price.

curl "https://developer.seaty.co.uk/v1/events/1024/ticket-categories" \
  -H "Authorization: Bearer sk_live_your_key_here"

Field	Type	Description
`id`	integer	The category id (matches `ticket_category_id` on tickets).
`name`	string \| null	The category name, for example "Adult".
`description`	string \| null	An optional description.
`price`	integer	Price per ticket, in pence.
`people`	integer	How many people one ticket of this category admits.
`sort_index`	integer	Display order within the event.
`limit`	integer \| null	Maximum of this category per order, if set.
`minimum_per_order`	integer \| null	Minimum required per order, if set.
`hidden`	boolean	Whether the category is hidden from buyers.

Event dates: a date's orders and its sales summary.
Orders: drilling into a single order.

Need help? Email support@seaty.co.uk.

List events

Get one event

List an event's dates

List an event's ticket categories

Next