GET /gallery

Lists public gallery images and returns public album metadata.


GET /public-api/v1/gallery

Query Parameters

Name	Type	Required	Notes
`page`	integer	No	Defaults to `1`.
`limit`	integer	No	Defaults to `20`, maximum `500`.
`sortBy`	string	No	Gallery image sort field.
`sortOrder`	`asc` or `desc`	No	Sort direction.
`albumId`	UUID	No	Filter images by album.
`subFestProgramId`	UUID	No	Filter images by programme.
`categoryId`	UUID	No	Filter images by category.

Example

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

Response Data

The response includes standard context, data, and meta, plus gallery-specific collections.

Field	Notes
`data`	Paginated public gallery image items.
`galleryAlbums`	Public album summaries for the resolved festival.
`galleryImages`	The same public image list used by website compatibility routes.

Each image includes id, title, description, imageUrl, thumbnailUrl, album summary, programme/category references when public, and timestamps.