Skip to main content
GET
/
theatres
List Theatres
curl --request GET \
  --url https://api.example.com/theatres
{
  "theatres": [
    {
      "id": "<string>",
      "name": "<string>",
      "address": "<string>",
      "postcode": "<string>",
      "lat": 123,
      "lng": 123,
      "capacity": 123,
      "current_show_id": "<string>"
    }
  ]
}

​
Overview

Returns a list of all theatre venues in the database. Currently includes 32+ West End theatres in London with their locations, capacity, and current show information.

​
Request

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

​
Response

​
theatres
array
Array of theatre objects

​
Example Response

[
  {
    "id": "theatre-001",
    "name": "Her Majesty's Theatre",
    "address": "Haymarket",
    "postcode": "SW1Y 4QL",
    "lat": 51.5094,
    "lng": -0.1313,
    "capacity": 1216,
    "current_show_id": "550e8400-e29b-41d4-a716-446655440000"
  },
  {
    "id": "theatre-002",
    "name": "Victoria Palace Theatre",
    "address": "Victoria Street",
    "postcode": "SW1E 5EA",
    "lat": 51.4965,
    "lng": -0.1437,
    "capacity": 1550,
    "current_show_id": "550e8400-e29b-41d4-a716-446655440001"
  },
  {
    "id": "theatre-003",
    "name": "St Martin's Theatre",
    "address": "West Street",
    "postcode": "WC2H 9NZ",
    "lat": 51.5126,
    "lng": -0.1275,
    "capacity": 550,
    "current_show_id": "550e8400-e29b-41d4-a716-446655440002"
  }
]

​
Status Codes

StatusDescription
200Success - returns array of theatres
500Server error