Venues API
List the venues attached to your organisation's events, with their address and the free-text directions, parking and accessibility notes. Read-only, scoped to your organisation.
A venue is a place your events happen. These endpoints list the venue records attached to your organisation's events. They require the read scope and are scoped to your organisation.
| Method | Path | Returns |
|---|---|---|
| GET | /v1/venues | A paginated list of the venues used by your events. |
| GET | /v1/venues/{id} | A single venue. |
Events that use your organisation's own address (rather than a separate venue record) are not listed here. This endpoint returns the dedicated venue records linked to your events.
List venues
curl "https://developer.seaty.co.uk/v1/venues" \
-H "Authorization: Bearer sk_live_your_key_here"
| Field | Type | Description |
|---|---|---|
id | integer | The venue id. |
name | string | null | The venue name. |
street_address | string | null | Street address. |
city | string | null | City or town. |
postcode | string | null | Postcode. |
description | string | null | Free-text description of the venue. |
directions | string | null | How to get there. |
car_parking | string | null | Parking notes. |
accessibility | string | null | Accessibility notes. |
Get one venue
curl "https://developer.seaty.co.uk/v1/venues/204" \
-H "Authorization: Bearer sk_live_your_key_here"
Returns the same fields as the list. A 404 means the venue is not used by any event in your organisation.
Next
- Events: the events held at these venues, including their seating plans.
Need help? Email support@seaty.co.uk.