Skip to main content
GET
/
v1
/
voices
/
{id}
/
samples
List Voice Samples
curl --request GET \
  --url https://api.bland.ai/v1/voices/{id}/samples \
  --header 'authorization: <authorization>'
{
  "samples": []
}

​
Overview

Returns the training samples used to create a voice clone. Only voices owned by your org return samples; default voices and shared library voices return 400 VOICE_SAMPLES_ERROR with the message "Voice is a default voice and not owned by the user." Retrievable samples are only present for V1 (BTTS) voices. V2 and V3 voices both return [] even though they were cloned from a sample, because the underlying single source clip is not exposed via this endpoint. Use the source audio of your original clone for those.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
UUID of the voice.

​
Query Parameters

​
include_audio
boolean
default:"false"
When true, includes base64-encoded audio data with each sample. Increases response size significantly. Use Get Voice Sample for a single sample with audio instead.

​
Response

​
samples
array
Array of training sample records. Empty array for V3 voices.
{
  "samples": []
}
Docs for agents: llms.txt