Errors

The public REST API returns JSON error responses with standard HTTP status codes.

For 400, 401, 403, 404, and 422, fix the request before retrying. For 429, wait before sending the request again.

Common Errors

Status	When it happens	Typical fix
`400`	A required query parameter is missing.	Add the required query value shown on the page.
`401`	The API key is missing, invalid, inactive, or expired.	Send a valid `X-API-Key` value or rotate the key.
`403`	The key cannot access the requested festival data.	Check that the key and endpoint belong together.
`404`	A requested public resource was not found.	Check that the id belongs to public festival data.
`422`	Query parameter validation failed.	Use valid UUIDs, enums, booleans, and date strings.
`429`	Too many requests were sent in a short time.	Retry after waiting.
`500`	Unexpected server error.	Retry later and report the timestamp and endpoint.


{
  "statusCode": 401,
  "message": "Invalid API key"
}