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

​
Overview

Returns detailed information about a single theatre venue identified by its unique ID.

​
Path Parameters

​
id
string
required
The unique identifier of the theatre

​
Request

curl https://entertheatre.com/api/theatres/theatre-001

​
Response

​
id
string
required
Unique identifier for the theatre
​
name
string
required
Name of the theatre
​
address
string
Street address of the theatre
​
postcode
string
UK postcode
​
lat
number
Latitude coordinate
​
lng
number
Longitude coordinate
​
capacity
number
Seating capacity of the theatre
​
current_show_id
string
ID of the show currently running at this theatre

​
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"
}

​
Error Response

{
  "error": "Theatre not found"
}

​
Status Codes

StatusDescription
200Success - returns theatre object
404Theatre not found
500Server error