Public REST API

These are the public integration routes for reading festival website data.

All requests are read-only, accept query parameters, and return JSON. Send your API key as described in Authentication.

Common Starting Points

Published updates and announcements.

Active public programmes for a sub-fest.

Published programme and candidate results.

Public filter options for the festival.

Endpoint	Purpose
`GET /news`	Published public news.
`GET /gallery`	Public gallery images and album metadata.
`GET /downloads`	Public downloadable files.

Endpoint	Purpose
`GET /subfests`	Active sub-fests for the festival.
`GET /programmes`	Active public programmes for a sub-fest.
`GET /candidates`	Active public candidates for a sub-fest.
`GET /teams`	Teams for a sub-fest.
`GET /categories`	Categories for a sub-fest.
`GET /filters`	Public filter options for the festival.

Endpoint	Purpose
`GET /schedules`	Public programme schedules.
`GET /programme-detail`	Public detail for one programme.
`GET /programme-result`	Published results for one programme.
`GET /programme-results`	Programmes with published results.
`GET /candidate-detail`	Public detail for one candidate.
`GET /candidate-result`	Published results for one candidate.
`GET /candidate-registrations`	Public registrations for one candidate.
`GET /topper-placeholders`	Published topper placeholders.
`GET /toppers`	Ranking entries for one placeholder.
`GET /page-toppers`	Website page-specific topper data.

Most list endpoints support:

Name	Type	Notes
`subFestSlug`	string	Optional public sub-fest selector when supported by the endpoint logic.
`page`	integer	Starts at `1`.
`limit`	integer	Maximum `500`.
`sortBy`	string	Endpoint-specific sort field.
`sortOrder`	`asc` or `desc`	Direction for `sortBy`.