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

> Retrieve a specific cast member assignment by ID

## Overview

Returns detailed information about a single cast member assignment identified by its unique ID.

## Path Parameters

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

## Request

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

  ```javascript JavaScript theme={null}
  const castMemberId = 'cast-001';
  const response = await fetch(`https://entertheatre.com/api/cast-members/${castMemberId}`);
  const castMember = await response.json();
  ```

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

  cast_member_id = 'cast-001'
  response = requests.get(f'https://entertheatre.com/api/cast-members/{cast_member_id}')
  cast_member = response.json()
  ```
</CodeGroup>

## Response

<ResponseField name="id" type="string" required>
  Unique identifier for the cast member assignment
</ResponseField>

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

<ResponseField name="production_id" type="string" required>
  ID of the production
</ResponseField>

<ResponseField name="role_id" type="string">
  ID of the role/character (if applicable)
</ResponseField>

<ResponseField name="role_type" type="string" required>
  Type of role: `principal`, `ensemble`, `understudy`, `swing`, `standby`, `alternate`
</ResponseField>

<ResponseField name="billing_order" type="number">
  Order in the billing (1 = top billing)
</ResponseField>

### Example Response

```json theme={null}
{
  "id": "cast-001",
  "person_id": "person-001",
  "production_id": "prod-001",
  "role_id": "role-001",
  "role_type": "principal",
  "billing_order": 1
}
```

## Error Response

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

## Status Codes

| Status | Description                          |
| ------ | ------------------------------------ |
| `200`  | Success - returns cast member object |
| `404`  | Cast member not found                |
| `500`  | Server error                         |