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

# Get Theatre

> Retrieve a specific theatre by ID

## Overview

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

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the theatre
</ParamField>

## Request

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

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

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

  theatre_id = 'theatre-001'
  response = requests.get(f'https://entertheatre.com/api/theatres/{theatre_id}')
  theatre = response.json()
  ```
</CodeGroup>

## Response

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

### 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"
}
```

## Error Response

```json theme={null}
{
  "error": "Theatre not found"
}
```

## Status Codes

| Status | Description                      |
| ------ | -------------------------------- |
| `200`  | Success - returns theatre object |
| `404`  | Theatre not found                |
| `500`  | Server error                     |