GET /teams

Lists teams for one sub-fest.


GET /public-api/v1/teams

Query Parameters

Name	Type	Required	Notes
`subFestId`	UUID	Yes	Sub-fest to list teams from.
`page`	integer	No	Defaults to `1`.
`limit`	integer	No	Defaults to `20`, maximum `500`.
`sortBy`	string	No	Team sort field.
`sortOrder`	`asc` or `desc`	No	Sort direction.
`search`	string array	No	Text search terms.
`colorCode`	string array	No	Filter by team color.
`hasCandidates`	boolean array	No	Filter by candidate presence.

Example

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

Response Data

Each item includes id, name, displayName, publicName, motto, logoUrl, colorCode, displayOrder, level, parentTeam, and candidateCount.