GET /programmes

Lists active public programmes for one sub-fest.


GET /public-api/v1/programmes

Query Parameters

Name	Type	Required	Notes
`subFestId`	UUID	Yes	Sub-fest to list programmes from.
`page`	integer	No	Defaults to `1`.
`limit`	integer	No	Defaults to `20`, maximum `500`.
`sortBy`	string	No	Programme sort field.
`sortOrder`	`asc` or `desc`	No	Sort direction.
`search`	string	No	Text search.
`categoryIds`	UUID array	No	Filter by categories.
`venues`	UUID array	No	Filter by venue ids.
`status`, `statuses`	enum or enum array	No	Public output is restricted to active public programmes.
`programType`	enum	No	Filter by programme type.
`programCodePattern`	string	No	Filter by code pattern.
`collectionId`, `collectionIds`	UUID or UUID array	No	Filter by collections.
`judges`	UUID array	No	Filter by judge ids.
`positionCriteriaId`	UUID	No	Filter by position criteria.
`gradeCriteriaId`	UUID	No	Filter by grade criteria.
`requiresTopicRegistration`	boolean	No	Filter by topic requirement.
`candidateRegistrationOpen`	boolean	No	Filter by candidate registration window.
`topicRegistrationOpen`	boolean	No	Filter by topic registration window.
`hasSchedule`	boolean	No	Filter by schedule presence.
`hasResults`	boolean	No	Filter by result presence.
`hasJudges`	boolean	No	Filter by judge assignment.
`hasRegistrations`	boolean	No	Filter by registrations.

Example

curl \
  -H "X-API-Key: fst_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://testapi.festie.app/public-api/v1/programmes?subFestId=00000000-0000-4000-8000-000000000000&hasResults=true"

Response Data

Each item includes id, status, publishedAt, subFest, program, category, nextSchedule, resultCount, and registrationCount.