curl -X GET 'https://api.elevenlabs.io/v1/voices/pvc/voice-id/samples/sample-id/audio?remove_background_noise=false' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/audio (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Retrieve Voice Sample Audio

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X GET 'https://api.elevenlabs.io/v1/voices/pvc/voice-id/samples/sample-id/audio?remove_background_noise=false' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| voice_id | path | string | Yes | Voice ID to be used, you can use https://api.elevenlabs.i... |
| sample_id | path | string | Yes | Sample ID to be used |
| remove_background_noise | query | boolean | No | If set will remove background noise for voice samples usi... |

## Response (200 OK)
{"audio_base_64":"audio_base_64","duration_secs":5}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

GET

/v1/voices/pvc/{voice_id}/samples/{sample_id}/audio

ElevenLabs API

Retrieve Voice Sample Audio

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 211 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/voices/pvc/voice-id/samples/sample-id/audio?remove_background_noise=false' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
voice_id	path	string	Yes	Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.
sample_id	path	string	Yes	Sample ID to be used
remove_background_noise	query	boolean	No	If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse.

Response 200 OK

{
  "audio_base_64": "audio_base_64",
  "duration_secs": 5,
  "media_type": "audio/mpeg",
  "sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
  "voice_id": "DCwhRBWXzGAHq8TQ4Fs18"
}