Skip to main content
GET
List events

Authorizations

Authorization
string
header
required

Sign in as a person: Planner shows them what the agent asks for (planner:read, planner:propose) and they agree. The agent then sees what they can see. Discovery: /.well-known/oauth-protected-resource.

Scopes

planner:read

Read the festival records you can see in Planner.

Query Parameters

edition
integer

Read another edition by its year, e.g. 2027. Default: the current edition.

edition_id
string<uuid>

Read another edition by its id.

include
string

Add related records, comma-separated: venue (The venue); authors (Authors and speakers); chairs (Chairs); interviewers (Interviewers); intro_wrap (Intro / wrap); staff (Staff (front of house, security, technicians)); books (Books at the event).

page
integer
default:1
Required range: x >= 1
per_page
integer
default:50
Required range: 1 <= x <= 200
q
string

Search title, description (part of the value, any case).

updated_since
string<date-time>

Only records changed at or after this time: for keeping a copy in sync.

status
string

draft, confirmed, cancelled…

venue_id
string<uuid>

Events at this venue.

event_type
string

Events of this type.

is_public
boolean

true for events on the public listing.

starts_after
string<date-time>

Starting at or after this time (ISO 8601).

starts_before
string<date-time>

Starting at or before this time (ISO 8601).

tag
string

Events carrying this schedule tag.

Response

A page of events.

data
object[]
meta
object