Skip to main content
GET
/
v1
/
voices
/
{id}
/
samples
/
{sample_id}
Get Voice Sample
curl --request GET \
  --url https://api.bland.ai/v1/voices/{id}/samples/{sample_id} \
  --header 'authorization: <authorization>'
HTTP/1.1 200 OK
Content-Type: audio/wav
Content-Length: 245318
Content-Disposition: attachment; filename="sample-d15b199a.wav"

<WAV binary>

​
Overview

Returns a single training sample for a voice you own. By default the response is the raw WAV audio. Pass ?format=json to get the metadata plus base64-encoded audio instead. Only voices owned by your org return samples. Default voices and shared-library voices return 400 VOICE_SAMPLE_ERROR.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
UUID of the parent voice.
​
sample_id
string
required
UUID of the sample to fetch.

​
Query Parameters

​
format
string
default:"audio"
Response format. audio returns the raw WAV binary, json returns sample metadata with base64-encoded audio under data.

​
Response

With format=audio (default), returns the WAV binary with:
  • Content-Type: audio/wav
  • Content-Disposition: attachment; filename="sample-<id>.wav"
With format=json, returns sample metadata.
​
sample
object
Only present in JSON mode.
HTTP/1.1 200 OK
Content-Type: audio/wav
Content-Length: 245318
Content-Disposition: attachment; filename="sample-d15b199a.wav"

<WAV binary>
Docs for agents: llms.txt