API Reference

Use Festie’s public REST API to read public festival website data from your own integration. The API is read-only and returns public-safe JSON.

Use this backend as the base URL:

https://testapi.festie.app/public-api/v1/news

Start Here

Send your API key with each request.

Browse every public data endpoint.

Understand context, lists, pagination, and filters.

Fix common request and validation errors.

Send your key in the X-API-Key header:

curl \
  -H "X-API-Key: fst_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://testapi.festie.app/public-api/v1/news?page=1&limit=10"

The public API only returns data that can be shown on a public festival website:

Published public news.
Public gallery images, albums, and downloads.
Active sub-fests, teams, categories, candidates, and programmes.
Published results only.
No draft results, private candidate contact fields, admin-only settings, or secrets.