GET /toppers

Lists ranking entries for one topper placeholder.


GET /public-api/v1/toppers

Query Parameters

Name	Type	Required	Notes
`topperPlaceholderId`	UUID	Yes	Published topper placeholder id.
`page`	integer	No	Defaults to `1`.
`limit`	integer	No	Defaults to `20`, maximum `500`.
`sortBy`	string	No	Topper entry sort field.
`sortOrder`	`asc` or `desc`	No	Sort direction.

Example

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

Response Shape


{
  "context": {},
  "placeholder": {},
  "data": [],
  "meta": {}
}

Each topper entry includes rank, points, program count, candidate/team/section/group fields, and last result date.