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

> Retrieve all performers and crew members

## Overview

Returns a list of all people (performers, cast members, and crew) in the database.

## Request

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

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

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

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

## Response

<ResponseField name="people" type="array">
  Array of person objects

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

    <ResponseField name="name" type="string" required>
      Full name of the person
    </ResponseField>

    <ResponseField name="bio" type="string">
      Biography or description
    </ResponseField>

    <ResponseField name="image" type="string">
      URL to the person's headshot
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
[
  {
    "id": "person-001",
    "name": "Elaine Paige",
    "bio": "Legendary West End star known for originating roles in Evita and Cats.",
    "image": "https://rluylvquemmzgljdklby.supabase.co/storage/v1/object/public/people/elaine-paige.jpg"
  },
  {
    "id": "person-002",
    "name": "Michael Ball",
    "bio": "Award-winning musical theatre actor and singer.",
    "image": "https://rluylvquemmzgljdklby.supabase.co/storage/v1/object/public/people/michael-ball.jpg"
  },
  {
    "id": "person-003",
    "name": "Imelda Staunton",
    "bio": "Acclaimed British actress known for stage and screen roles.",
    "image": "https://rluylvquemmzgljdklby.supabase.co/storage/v1/object/public/people/imelda-staunton.jpg"
  }
]
```

## Status Codes

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