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

# List Voices

## List Voices

Retrieve available voices from ElevenLabs that can be used for voice synthesis.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.example.com/api/v1/voices?search=professional&gender=male" \
    -H "X-API-Key: your-api-key-here"
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    search: 'professional',
    gender: 'male'
  });

  const response = await fetch(`https://api.example.com/api/v1/voices?${params}`, {
    method: 'GET',
    headers: {
      'X-API-Key': 'your-api-key-here'
    }
  });

  const data = await response.json();
  ```

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

  headers = {
      'X-API-Key': 'your-api-key-here'
  }

  params = {
      'search': 'professional',
      'gender': 'male'
  }

  response = requests.get(
      'https://api.example.com/api/v1/voices',
      headers=headers,
      params=params
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": {
      "code": 200,
      "message": "Voices retrieved successfully"
    },
    "data": [
      {
        "voice_id": "21m00Tcm4TlvDq8ikWAM",
        "name": "Rachel",
        "category": "premade",
        "description": "Calm and professional voice",
        "gender": "female",
        "accent": "american",
        "age": "young",
        "use_case": "narration"
      }
    ],
    "total_count": 1
  }
  ```
</ResponseExample>

<OpenApiExplorer />