GET /topper-placeholders

Lists published topper placeholders for a sub-fest.


GET /public-api/v1/topper-placeholders

Query Parameters

Name	Type	Required	Notes
`subFestId`	UUID	Yes	Sub-fest to list placeholders from.
`page`	integer	No	Defaults to `1`.
`limit`	integer	No	Defaults to `20`, maximum `500`.
`sortBy`	string	No	Placeholder sort field.
`sortOrder`	`asc` or `desc`	No	Sort direction.
`isPublished`	boolean	No	Public output is restricted to published placeholders.
`entityType`	enum	No	Topper entity type.
`scopeType`	enum	No	Topper scope type.

Example

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

Response Data

Each item includes id, label, scopeType, entityType, sectionKey, collectionKey, rankingBasis, displayTopN, displayOrder, and lastComputedAt.