curl -X GET 'https://api.elevenlabs.io/v1/shared-voices?page_size=30&category=professional&gender=example-gender&age=example-age&accent=example-accent&language=example-language&locale=example-locale&search=example-search&use_cases=example&descriptives=example&featured=false&min_notice_period_days=10&include_custom_rates=true&include_live_moderated=true&reader_app_enabled=false&owner_id=owner-id&sort=created_date&page=0' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/shared-voices (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> Get Voices

## 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/shared-voices?page_size=30&category=professional&gender=example-gender&age=example-age&accent=example-accent&language=example-language&locale=example-locale&search=example-search&use_cases=example&descriptives=example&featured=false&min_notice_period_days=10&include_custom_rates=true&include_live_moderated=true&reader_app_enabled=false&owner_id=owner-id&sort=created_date&page=0' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| page_size | query | integer | No | How many shared voices to return at maximum. Can not exce... |
| category | query | string | No | Voice category used for filtering |
| gender | query | string | No | Gender used for filtering |
| age | query | string | No | Age used for filtering |

## Response (200 OK)
{"has_more":false,"total_count":0}

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

GET

/v1/shared-voices

ElevenLabs API

Get Voices

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
→ 221 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/shared-voices?page_size=30&category=professional&gender=example-gender&age=example-age&accent=example-accent&language=example-language&locale=example-locale&search=example-search&use_cases=example&descriptives=example&featured=false&min_notice_period_days=10&include_custom_rates=true&include_live_moderated=true&reader_app_enabled=false&owner_id=owner-id&sort=created_date&page=0' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
page_size	query	integer	No	How many shared voices to return at maximum. Can not exceed 100, defaults to 30.
category	query	string	No	Voice category used for filtering
gender	query	string	No	Gender used for filtering
age	query	string	No	Age used for filtering
accent	query	string	No	Accent used for filtering
language	query	string	No	Language used for filtering
locale	query	string	No	Locale used for filtering
search	query	string	No	Search term used for filtering
use_cases	query	string[]	No	Use-case used for filtering
descriptives	query	string[]	No	Search term used for filtering
featured	query	boolean	No	Filter featured voices
min_notice_period_days	query	integer	No	Filter voices with a minimum notice period of the given number of days.
include_custom_rates	query	boolean	No	Include/exclude voices with custom rates
include_live_moderated	query	boolean	No	Include/exclude voices that are live moderated
reader_app_enabled	query	boolean	No	Filter voices that are enabled for the reader app
owner_id	query	string	No	Filter voices by public owner ID
sort	query	string	No	Sort criteria. Must be one of: created_date, usage_character_count_1y, trending, cloned_by_count.
page	query	integer	No	query parameter page.

Response 200 OK

{
  "has_more": false,
  "total_count": 0,
  "voices": [
    {
      "accent": "american",
      "age": "young",
      "category": "professional",
      "cloned_by_count": 11,
      "date_unix": 1714423232,
      "description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
      "descriptive": "calm",
      "featured": false,
      "free_users_allowed": true,
      "gender": "Female",
      "language": "en",
      "live_moderation_enabled": false,
      "name": "Alita",
      "play_api_usage_character_count_1y": 12852,
      "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
      "public_owner_id": "63e84100a6bf7874ba37a1bab9a31828a379ec94b891b401653b655c5110880f",
      "rate": 1,
      "usage_character_count_1y": 12852,
      "usage_character_count_7d": 12852,
      "use_case": "characters_animation",
      "verified_languages": [
        {
          "accent": "american",
          "language": "en",
          "locale": "en-US",
          "model_id": "eleven_multilingual_v2",
          "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3"
        }
      ],
      "voice_id": "sB1b5zUrxQVAFl2PhZFp"
    }
  ]
}