Seating API
Read an event's seating plans and the named seating sections (with colours and seat counts) behind reserved seating. Read-only, scoped to your organisation.
Seaty is built around reserved seating, and these endpoints expose the structure behind it: the seating plans attached to an event, and the named sections within them. They require the read scope and are scoped to your organisation. Both are sub-resources of an event.
| Method | Path | Returns |
|---|---|---|
| GET | /v1/events/{id}/seating-plans | A paginated list of the event's seating plans. |
| GET | /v1/events/{id}/sections | A paginated list of the seating sections across the event's plans. |
List an event's seating plans
curl "https://developer.seaty.co.uk/v1/events/501/seating-plans" \
-H "Authorization: Bearer sk_live_your_key_here"
| Field | Type | Description |
|---|---|---|
id | integer | The seating-plan id. |
guid | string | null | The plan's public reference. |
name | string | null | The plan name. |
row_count | integer | Number of rows in the plan grid. |
column_count | integer | Number of columns in the plan grid. |
seat_count | integer | Total seats defined on the plan. |
section_count | integer | Number of seating sections on the plan. |
sort_index | integer | Display order of the plan on the event. |
An event most often has a single plan, but can carry more than one.
List an event's sections
A section (a seat category, for example "Stalls" or "Circle") is the named, coloured area a seat belongs to. This is the structured form of the section_name that appears on each of an order's tickets.
curl "https://developer.seaty.co.uk/v1/events/501/sections" \
-H "Authorization: Bearer sk_live_your_key_here"
| Field | Type | Description |
|---|---|---|
id | integer | The section id. |
name | string | null | The section name (for example "Stalls"). |
colour | string | null | The display colour for the section. |
description | string | null | Free-text description, if set. |
seating_plan_id | integer | The plan this section belongs to. |
seat_count | integer | Number of seats in this section. |
sort_index | integer | Display order of the section. |
Next
- Orders: each ticket on an order carries its seat name and
section_name.
Need help? Email support@seaty.co.uk.