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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Query Parameters

<ParamField query="limit" type="number" default="20">
  Number of generations to return.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of generations to skip for pagination.
</ParamField>

<ParamField query="voice_id" type="string">
  Filter results to a specific voice.
</ParamField>

### Response

<ResponseField name="data" type="array">
  List of stored TTS generation objects.

  <Expandable title="Generation object">
    <ResponseField name="id" type="string">
      Unique identifier for the generation.
    </ResponseField>

    <ResponseField name="org_id" type="string">
      The organization that created the generation.
    </ResponseField>

    <ResponseField name="user_id" type="string">
      The user that created the generation.
    </ResponseField>

    <ResponseField name="text" type="string">
      The text that was synthesized.
    </ResponseField>

    <ResponseField name="voice_id" type="string">
      The voice used for synthesis.
    </ResponseField>

    <ResponseField name="output_format" type="string">
      The audio format of the generation (e.g. `pcm_44100`).
    </ResponseField>

    <ResponseField name="latency_ms" type="number">
      Time in milliseconds from request to first audio.
    </ResponseField>

    <ResponseField name="cost" type="number">
      Cost in USD for this generation.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the generation was created.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Total number of generations matching the query.
</ResponseField>

<ResponseField name="limit" type="number">
  The limit applied to this request.
</ResponseField>

<ResponseField name="offset" type="number">
  The offset applied to this request.
</ResponseField>

<ResponseField name="errors" type="null | array">
  Any errors encountered, or `null` if successful.
</ResponseField>

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)