> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entertheatre.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Theatres

> Retrieve all West End theatre venues

## 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

<CodeGroup>
  ```bash cURL theme={null}
  curl https://entertheatre.com/api/theatres
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://entertheatre.com/api/theatres');
  const theatres = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get('https://entertheatre.com/api/theatres')
  theatres = response.json()
  ```
</CodeGroup>

## Response

<ResponseField name="theatres" type="array">
  Array of theatre objects

  <Expandable title="Theatre Object">
    <ResponseField name="id" type="string" required>
      Unique identifier for the theatre
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Name of the theatre
    </ResponseField>

    <ResponseField name="address" type="string">
      Street address of the theatre
    </ResponseField>

    <ResponseField name="postcode" type="string">
      UK postcode
    </ResponseField>

    <ResponseField name="lat" type="number">
      Latitude coordinate
    </ResponseField>

    <ResponseField name="lng" type="number">
      Longitude coordinate
    </ResponseField>

    <ResponseField name="capacity" type="number">
      Seating capacity of the theatre
    </ResponseField>

    <ResponseField name="current_show_id" type="string">
      ID of the show currently running at this theatre
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
[
  {
    "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

| Status | Description                         |
| ------ | ----------------------------------- |
| `200`  | Success - returns array of theatres |
| `500`  | Server error                        |