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

# List Voices

> List all voices available to your account.

## Overview

Returns every voice your account can use: Bland's curated default voices, voices you have cloned, voices you have added to your library from the public catalog, and voices owned by your org.

For just the publicly-shared library, use [List Shared Voices](https://docs.bland.ai/api-v1/get/voices-shared.md) instead.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Response

**voices** `array`

Array of voices.

**Voice fields**

**id** `string`

UUID of the voice. Pass this as `voice_id` to [Speak](https://docs.bland.ai/api-v2/post/tts.md) or any voice management endpoint.

**name** `string`

Display name. For curated default voices this can also be used in the `voice` field when sending calls.

**description** `string | null`

Short human-readable description of the voice.

**public** `boolean`

`true` for shared library voices and Bland curated voices, `false` for voices private to your org.

**tags** `string[]`

Labels describing the voice (language, style, source). Bland's recommended curated voices carry the `"Bland Curated"` tag.

**user\_id** `string | null`

Owner UUID. `null` for curated default voices.

**voice\_id** `string`

Underlying model identifier. Format varies by engine; treat as opaque.

**service** `string`

Engine identifier. One of `BTTS`, `BTTS_V2`, `BTTS_V3`, or `LEGACY`.

**finetuned** `boolean`

`true` if the voice has been fine-tuned past the base clone.

**is\_creator\_voice** `boolean`

`true` for voices in the Bland creator program. Creator voices may carry a per-character fee in addition to synthesis cost.

**ratings** `number`

Total number of ratings the voice has received.

**total\_ratings** `number`

Alias of `ratings` returned for backwards compatibility.

**average\_rating** `number`

Average rating, 0-5.

**my\_rating** `number | null`

The calling user's rating for this voice, if any. `null` when the caller has not rated it. Submit via [Rate Voice](https://docs.bland.ai/api-v1/post/voices-id-rate.md).

**creator\_display\_name** `string | null`

Creator name for voices in the creator program. `null` otherwise.

```json Response theme={null}
{
  "voices": [
    {
      "id": "d4610ec1-933d-44c9-a05f-53df2437808d",
      "name": "Karen",
      "description": "A mature female with a General American accent, nasal and deadpan, with a moderate pace, for customer support and IVR prompts.",
      "public": true,
      "tags": ["English", "Female", "General American", "customer support", "Bland Curated"],
      "user_id": null,
      "voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
      "service": "BTTS_V3",
      "finetuned": false,
      "is_creator_voice": false,
      "ratings": 1234,
      "total_ratings": 1234,
      "average_rating": 4.6,
      "my_rating": null,
      "creator_display_name": null
    },
    {
      "id": "5f29c646-1881-4882-8d8c-8616a2d5ce9c",
      "name": "MyClone",
      "description": null,
      "public": false,
      "tags": ["Beige Clone V3", "cloned", "female"],
      "user_id": "ffcf63aa-6298-471f-91ad-5d2653812042",
      "voice_id": "c18a1cd5-91ef-4b06-841a-e58b8b487e8c",
      "service": "BTTS_V3",
      "finetuned": false,
      "is_creator_voice": false,
      "ratings": 0,
      "total_ratings": 0,
      "average_rating": 0,
      "my_rating": null,
      "creator_display_name": null
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.