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

# Get Voice Sample

> Download a single training sample as audio or JSON metadata.

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

**Sample fields**

**id** `string`

**voice\_id** `string`

**transcription** `string | null`

**duration\_seconds** `number`

**audio\_data** `string`

Base64-encoded WAV audio.

**created\_at** `string`

```http Audio Response theme={null}
HTTP/1.1 200 OK
Content-Type: audio/wav
Content-Length: 245318
Content-Disposition: attachment; filename="sample-d15b199a.wav"

<WAV binary>
```

```json JSON Response theme={null}
{
  "sample": {
    "id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
    "voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
    "transcription": "Hello and welcome to Bland.",
    "duration_seconds": 11.4,
    "audio_data": "<base64 WAV>",
    "created_at": "2026-06-22T21:34:31.347Z"
  }
}
```

```json Audio Not Found theme={null}
{
  "data": null,
  "errors": [
    { "error": "AUDIO_NOT_FOUND", "message": "No audio data found for this sample" }
  ]
}
```

***

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.