UK Competitive Arts Festivals API

Music, dance, and drama festival data in one developer-friendly API.

Get comprehensive UK festival listings, editions, dates, and locations to power discovery tools, calendars, and cultural platforms.

Free & Open: No API keys required. No authentication needed. Just start making requests!

Get Started

Explore our interactive OpenAPI/Swagger documentation to see all available endpoints, request parameters, response schemas, and try out the API directly in your browser.

Interactive API Docs OpenAPI Schema (JSON)

Quick Start Examples

Example: List Festivals 
curl https://festivalfinder.uk/api/v1/festivals/
Example: Get Festival by Slug 
curl https://festivalfinder.uk/api/v1/festivals/southampton-festival-of-music-and-drama/
Example: Filter Festivals 
curl "https://festivalfinder.uk/api/v1/festivals/?county=hampshire&search=music"

Festivals Endpoint

Browse and search festivals with filtering by location, affiliation, and status.

  • GET /api/v1/festivals/
    List all festivals (paginated)
  • GET /api/v1/festivals/{slug}/
    Get festival by slug with next edition

Editions Endpoint

Access festival edition data including dates, entry deadlines, and venue information.

  • GET /api/v1/editions/
    List all editions (paginated)
  • GET /api/v1/editions/{uuid}/
    Get edition by UUID

Rate Limiting

All endpoints are rate-limited to 100 requests per hour per IP address.

Rate limit headers are included in all responses:

  • X-RateLimit-Limit - Maximum requests per hour
  • X-RateLimit-Remaining - Remaining requests
  • X-RateLimit-Reset - Reset timestamp

Pagination

List endpoints support offset-based pagination:

  • page - Page number (default: 1)
  • page_size - Results per page (default: 20, max: 100)

Responses include count, next, and previous fields.

Filtering & Search

Festivals Filters

  • county - Filter by UK county
  • town - Filter by town/city
  • affiliation - Filter by affiliation type
  • status - Filter by festival status
  • search - Text search in name, description, location

Editions Filters

  • festival_slug - Filter by festival slug
  • year - Filter by year
  • upcoming - Show only upcoming editions
  • current - Show only currently running editions
  • past - Show only past editions

Data Privacy

We take data privacy seriously. The API only exposes public festivals and editions information. Sensitive GDPR fields (contact emails, submitter names, consent data) are never included in API responses.