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

> Retrieve all theatre shows

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

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

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

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

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

## Response

<ResponseField name="shows" type="array">
  Array of show objects

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

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

    <ResponseField name="type" type="string" required>
      Show type: `musical`, `play`, `comedy`, or `drama`
    </ResponseField>

    <ResponseField name="description" type="string">
      Description of the show
    </ResponseField>

    <ResponseField name="image" type="string">
      URL to the show's image
    </ResponseField>

    <ResponseField name="booking_until" type="string">
      Date until which bookings are available (ISO 8601 format)
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

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

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