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

> List the training samples attached to a voice clone you own.

## 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](https://docs.bland.ai/api-v1/get/voices-id-samples-sample-id.md) for a single sample with audio instead.

***

## Response

**samples** `array`

Array of training sample records. Empty array for V3 voices.

**Sample fields**

**id** `string`

UUID of the sample.

**voice\_id** `string`

UUID of the parent voice.

**transcription** `string | null`

Transcribed text for the sample. `null` if transcription has not been generated yet.

**duration\_seconds** `number`

Length of the sample audio.

**audio\_data** `string`

Base64-encoded audio. Only present when `include_audio=true`.

**created\_at** `string`

ISO 8601 timestamp.

```json Response theme={null}
{
  "samples": []
}
```

```json Not Owned theme={null}
{
  "data": null,
  "errors": [
    { "error": "VOICE_SAMPLES_ERROR", "message": "Voice is a default voice and not owned by the user." }
  ]
}
```

***

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.