Skip to main content
GET
/
shows
List Shows
curl --request GET \
  --url https://api.example.com/shows
{
  "shows": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "<string>",
      "description": "<string>",
      "image": "<string>",
      "booking_until": "<string>"
    }
  ]
}

​
Overview

Returns a list of all theatre shows in the database. Shows include musicals, plays, comedies, and dramas currently or recently running in the West End.

​
Request

curl https://entertheatre.com/api/shows

​
Response

​
shows
array
Array of show objects

​
Example Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "The Phantom of the Opera",
    "type": "musical",
    "description": "Andrew Lloyd Webber's legendary musical about a mysterious phantom who haunts the Paris Opera House.",
    "image": "https://rluylvquemmzgljdklby.supabase.co/storage/v1/object/public/shows/phantom.jpg",
    "booking_until": "2025-06-30"
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "name": "Hamilton",
    "type": "musical",
    "description": "The story of America's founding father Alexander Hamilton, told through hip-hop music.",
    "image": "https://rluylvquemmzgljdklby.supabase.co/storage/v1/object/public/shows/hamilton.jpg",
    "booking_until": "2025-12-31"
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "name": "The Mousetrap",
    "type": "play",
    "description": "Agatha Christie's world-famous murder mystery, the longest-running show in West End history.",
    "image": "https://rluylvquemmzgljdklby.supabase.co/storage/v1/object/public/shows/mousetrap.jpg",
    "booking_until": null
  }
]

​
Status Codes

StatusDescription
200Success - returns array of shows
500Server error