Skip to main content
GET
/
v1
/
speak
/
samples
List TTS Generations
curl --request GET \
  --url https://api.bland.ai/v1/speak/samples \
  --header 'authorization: <authorization>'
{
  "data": [
    {
      "id": "a3f8c2d1-4b5e-6789-0abc-def012345678",
      "org_id": "9e1d2c3b-4a5f-6780-bcde-f01234567890",
      "user_id": "5c6d7e8f-9012-3456-789a-bcdef0123456",
      "text": "Hello, this is a test of the text-to-speech system.",
      "voice_id": "2b3c4d5e-6f70-8901-2345-6789abcdef01",
      "output_format": "pcm_44100",
      "latency_ms": 1261,
      "cost": 0.011,
      "created_at": "2026-03-16T01:44:56.673Z"
    }
  ],
  "errors": null,
  "total": 1,
  "limit": 20,
  "offset": 0
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Query Parameters

​
limit
number
default:"20"
Number of generations to return.
​
offset
number
default:"0"
Number of generations to skip for pagination.
​
voice_id
string
Filter results to a specific voice.

​
Response

​
data
array
List of stored TTS generation objects.
​
total
number
Total number of generations matching the query.
​
limit
number
The limit applied to this request.
​
offset
number
The offset applied to this request.
​
errors
null | array
Any errors encountered, or null if successful.
{
  "data": [
    {
      "id": "a3f8c2d1-4b5e-6789-0abc-def012345678",
      "org_id": "9e1d2c3b-4a5f-6780-bcde-f01234567890",
      "user_id": "5c6d7e8f-9012-3456-789a-bcdef0123456",
      "text": "Hello, this is a test of the text-to-speech system.",
      "voice_id": "2b3c4d5e-6f70-8901-2345-6789abcdef01",
      "output_format": "pcm_44100",
      "latency_ms": 1261,
      "cost": 0.011,
      "created_at": "2026-03-16T01:44:56.673Z"
    }
  ],
  "errors": null,
  "total": 1,
  "limit": 20,
  "offset": 0
}