> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.resemble.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.resemble.ai/_mcp/server.

# List Voices

`GET https://app.resemble.ai/api/v2/voices`

Retrieve a paginated list of voices accessible to the user.

| Parameter                  | Type    | Required | Notes                                        |
| -------------------------- | ------- | -------- | -------------------------------------------- |
| `page`                     | integer | ❌        | Page number.                                 |
| `page_size`                | integer | ❌        | Items per page.                              |
| `pre_built_resemble_voice` | boolean | ❌        | Filter by pre-built voices.                  |
| `age`                      | string  | ❌        | Filter by age (comma-separated values).      |
| `gender`                   | string  | ❌        | Filter by gender (comma-separated values).   |
| `accents`                  | string  | ❌        | Filter by accents (comma-separated values).  |
| `use_case`                 | string  | ❌        | Filter by use case (comma-separated values). |
| `tone_of_voice`            | string  | ❌        | Filter by tone (comma-separated values).     |
| `advanced`                 | boolean | ❌        | Include advanced model information.          |
| `sample_url`               | boolean | ❌        | Include sample audio URLs.                   |
| `filters`                  | boolean | ❌        | Include filter metadata.                     |
| `voice_selector`           | boolean | ❌        | Format for voice selector UI.                |

```bash
curl 'https://app.resemble.ai/api/v2/voices?page=1&page_size=10' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
```

```json
{
  "success": true,
  "page": 1,
  "total_results": 10,
  "page_count": 1,
  "items": [
    {
      "uuid": "VOICE_UUID",
      "name": "Production Voice",
      "status": "ready",
      "voice_status": "ready",
      "default_language": "en-US",
      "supported_languages": ["en-US"],
      "dataset_url": null,
      "callback_uri": null,
      "source": "Custom Voice",
      "dataset_analysis_failure": false,
      "component_status": {
        "text_to_speech": { "status": "ready" },
        "fill": { "status": "ready" },
        "voice_conversion": { "status": "ready" }
      },
      "api_support": {
        "sync_tts": true,
        "async_tts": true,
        "fill": true,
        "sts": true
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:32:00Z"
    }
  ]
}
```