Developer API — Showday

Getting Started

To use the Showday API you need an API key. Email api@showday.co.uk with your name and what you're building — we'll send you a key within 48 hours.

Include your API key in every request as an X-Api-Key header, or as an api_key query parameter.

Base URL

https://www.showday.co.uk/api/v1

Authentication

curl https://www.showday.co.uk/api/v1/events \
  -H "X-Api-Key: YOUR_API_KEY"

Endpoints

List Events

GET /api/v1/events

Returns a paginated list of live events. Supports filtering by city, category, genre, venue and artist name.

Query Parameters

citystringFilter by city name (case insensitive)

categorystringmusic, sport, theatre, comedy, other

genrestringFilter by genre (e.g. "drum and bass")

venuestringFilter by venue name

artiststringSearch event titles for artist name

fromdateStart date filter (ISO format: 2026-04-01)

todateEnd date filter (ISO format: 2026-12-31)

pagenumberPage number (default: 1)

limitnumberResults per page (default: 20, max: 100)

{
  "events": [
    {
      "id": "69c7e6ac4c5456563b66af3a",
      "title": "Hamilton",
      "subtitle": "The Musical — West End",
      "category": "theatre",
      "genre": "Musical",
      "venue": "Victoria Palace Theatre",
      "city": "London",
      "postcode": "SW1E 5EA",
      "date": "2026-06-28T18:30:00.000Z",
      "doorsOpen": "18:30",
      "showTime": "19:30",
      "minAge": 10,
      "promoter": "Demo Promoter",
      "featured": true,
      "ticketUrl": "https://showday.co.uk/event.html?id=69c7e6ac...",
      "tiers": [
        {
          "name": "Rear Stalls",
          "price": 35,
          "capacity": 200,
          "sold": 40,
          "available": 160
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "pages": 1
  }
}

Get Single Event

GET /api/v1/events/:id

curl https://www.showday.co.uk/api/v1/events/69c7e6ac4c5456563b66af3a \
  -H "X-Api-Key: YOUR_API_KEY"

List Cities

GET /api/v1/cities

Returns all cities that have live events on Showday.

List Venues

GET /api/v1/venues

Returns all venues with live events. Filter by city with ?city=London.

Rate Limits

The API is limited to 200 requests per 15 minutes per API key. If you need higher limits, contact us.

Get an API Key

Email api@showday.co.uk with:

Your name and company/project
What you're building
Expected request volume

We'll respond within 48 hours with your key and any usage guidelines.