> ## 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 TTS Generations

> List your stored text-to-speech generations.

## 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.

**Generation object**

**id** `string`

Unique identifier for the generation.

**org\_id** `string`

The organization that created the generation.

**user\_id** `string`

The user that created the generation.

**text** `string`

The text that was synthesized.

**voice\_id** `string`

The voice used for synthesis.

**output\_format** `string`

The audio format of the generation (e.g. `pcm_44100`).

**latency\_ms** `number`

Time in milliseconds from request to first audio.

**cost** `number`

Cost in USD for this generation.

**created\_at** `string`

ISO 8601 timestamp of when the generation was created.

**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.

```json Response theme={null}
{
  "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
}
```

***

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.