> ## 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 Shared Voices

> Browse the public Bland voice library.

## Overview

Returns the catalog of publicly-shared voices in the Bland library. These are voices that other creators have published for everyone to use; they are not in your org's library until you call [Add Library Voice](https://docs.bland.ai/api-v1/post/voices-library-add-id.md).

Use this endpoint to power voice-picker UIs and discovery flows.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Query Parameters

**limit** `integer` (default: 50)

Number of voices to return.

**offset** `integer` (default: 0)

Pagination offset.

**search** `string`

Free-text search across voice name, description, and tags.

**language** `string`

Filter to voices tagged for a specific language (for example `en`, `es`, `ja`).

***

## Response

**voices** `array`

Array of shared voices.

**Voice fields**

**id** `string`

UUID of the shared voice. Pass to [Add Library Voice](https://docs.bland.ai/api-v1/post/voices-library-add-id.md) to add it to your org.

**name** `string`

Display name in the public library.

**description** `string | null`

**service** `string`

The voice's underlying TTS service. Examples: `BTTS_V2`, `BTTS_V3`.

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

`true` if the voice is part of the creator program. Creator voices may carry a per-character fee in addition to the synthesis cost.

**ratings** `number`

Total number of ratings the voice has received.

**rating\_count** `number`

Alias of `ratings` returned for backwards compatibility.

**rating\_avg** `number`

Average rating, 0-5.

**trending\_score** `number`

Internal score used to surface trending voices in the dashboard.

**tags** `string[]`

**created\_at** `string`

ISO 8601 timestamp.

**public** `boolean`

Always `true` for entries in the shared library.

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

Name of the creator who published the voice, if applicable.

**creator\_fee\_cents\_per\_1k** `number | null`

Per-character creator fee in cents per 1,000 characters. `null` for non-creator voices.

**creator\_fee\_cents\_per\_10k** `number | null`

Per-character creator fee in cents per 10,000 characters. `null` for non-creator voices.

```json Response theme={null}
{
  "voices": [
    {
      "id": "e657b253-ca1f-41cc-b25f-7267ae644519",
      "name": "StephenD",
      "description": null,
      "service": "BTTS_V2",
      "is_creator_voice": false,
      "ratings": 12,
      "rating_count": 12,
      "rating_avg": 4.5,
      "trending_score": 0,
      "tags": ["english", "male", "cloned"],
      "created_at": "2026-04-16T09:14:25.232Z",
      "public": true,
      "creator_display_name": null,
      "creator_fee_cents_per_1k": null,
      "creator_fee_cents_per_10k": 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.