Skip to main content
GET
/
v1
/
voices
/
shared
List Shared Voices
curl --request GET \
  --url https://api.bland.ai/v1/voices/shared \
  --header 'authorization: <authorization>'
{
  "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
    }
  ]
}

​
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. 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.
{
  "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