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

# List Speakers

> Browse available speaker voices with filtering

<Note>
  This endpoint does not require authentication.
</Note>

## Query Parameters

<ParamField query="gender" type="string">
  Filter by gender: `Male`, `Female`, or `Non-binary`
</ParamField>

<ParamField query="region" type="string">
  Filter by region (e.g., `Georgia`, `California`)
</ParamField>

<ParamField query="accent" type="string">
  Filter by accent (e.g., `Southern`, `General American`)
</ParamField>

<ParamField query="age_range" type="string">
  Filter by age bracket (e.g., `25-34`, `35-44`)
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of results to return (max 100)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of results to skip
</ParamField>

## Response

<ResponseField name="items" type="array" required>
  Array of speaker objects
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of matching speakers
</ResponseField>

<ResponseField name="has_more" type="boolean" required>
  Whether more results are available
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.destined.ai/v1/speakers?gender=Female&limit=10"
  ```

  ```typescript TypeScript theme={null}
  const speakers = await client.speakers.listSpeakersV1SpeakersGet({
    gender: "Female",
    region: "Georgia",
    limit: 10,
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "abc123-def456",
        "gender": "Female",
        "region": "Georgia",
        "accent": "Southern",
        "age_range": "25-34",
        "native_language": "English",
        "sample_audio_url": "https://voice.s3.amazonaws.com/samples/abc123.wav"
      }
    ],
    "total": 1500,
    "limit": 10,
    "offset": 0,
    "has_more": true
  }
  ```
</ResponseExample>