For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Connect
BlogHelp CenterAPI PricingSign up
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
  • API reference
    • Introduction
    • Authentication
    • Streaming
  • ElevenAgents
  • ElevenAPI
  • ElevenCreative
  • Core Resources
  • Workspace
  • Legacy
      • GETList voices
      • POSTVoice design
      • POSTSave a voice preview
LogoLogo
Login
Login
Connect
BlogHelp CenterAPI PricingSign up
LegacyVoices

List voices

Deprecated
GET
/v1/voices
GET
/v1/voices
$curl https://api.elevenlabs.io/v1/voices
1{
2  "voices": [
3    {
4      "voice_id": "21m00Tcm4TlvDq8ikWAM",
5      "name": "Rachel",
6      "category": "professional",
7      "fine_tuning": {
8        "is_allowed_to_fine_tune": true,
9        "state": {
10          "eleven_multilingual_v2": "fine_tuned"
11        },
12        "verification_failures": [],
13        "verification_attempts_count": 2,
14        "manual_verification_requested": false
15      },
16      "labels": {
17        "accent": "American",
18        "age": "middle-aged",
19        "description": "expressive",
20        "gender": "female",
21        "use_case": "social media"
22      },
23      "description": "A warm, expressive voice with a touch of humor.",
24      "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3",
25      "available_for_tiers": [
26        "creator",
27        "enterprise"
28      ],
29      "settings": {
30        "stability": 1,
31        "use_speaker_boost": true,
32        "similarity_boost": 1,
33        "style": 0,
34        "speed": 1
35      },
36      "sharing": {
37        "status": "enabled",
38        "history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
39        "date_unix": 1714204800,
40        "whitelisted_emails": [
41          "example@example.com"
42        ],
43        "public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18",
44        "original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
45        "financial_rewards_enabled": true,
46        "free_users_allowed": true,
47        "live_moderation_enabled": true,
48        "rate": 0.05,
49        "notice_period": 30,
50        "disable_at_unix": 1714204800,
51        "voice_mixing_allowed": false,
52        "featured": true,
53        "category": "professional",
54        "reader_app_enabled": true,
55        "liked_by_count": 100,
56        "cloned_by_count": 50,
57        "name": "Rachel",
58        "description": "A female voice with a soft and friendly tone.",
59        "labels": {
60          "accent": "American",
61          "gender": "female"
62        },
63        "review_status": "allowed",
64        "enabled_in_library": true,
65        "moderation_check": {
66          "date_checked_unix": 1714204800,
67          "name_value": "Rachel",
68          "name_check": true,
69          "description_value": "A female voice with a soft and friendly tone.",
70          "description_check": true,
71          "sample_ids": [
72            "sample1",
73            "sample2"
74          ],
75          "sample_checks": [
76            0.95,
77            0.98
78          ],
79          "captcha_ids": [
80            "captcha1",
81            "captcha2"
82          ],
83          "captcha_checks": [
84            0.95,
85            0.98
86          ]
87        },
88        "reader_restricted_on": [
89          {
90            "resource_type": "read",
91            "resource_id": "FCwhRBWXzGAHq8TQ4Fs18"
92          }
93        ]
94      },
95      "high_quality_base_model_ids": [
96        "eleven_v2_flash",
97        "eleven_flash_v2",
98        "eleven_turbo_v2_5",
99        "eleven_multilingual_v2",
100        "eleven_v2_5_flash",
101        "eleven_flash_v2_5",
102        "eleven_turbo_v2"
103      ],
104      "verified_languages": [
105        {
106          "language": "en",
107          "model_id": "eleven_multilingual_v2",
108          "accent": "american",
109          "locale": "en-US",
110          "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3"
111        }
112      ],
113      "voice_verification": {
114        "requires_verification": false,
115        "is_verified": true,
116        "verification_failures": [],
117        "verification_attempts_count": 0,
118        "language": "en",
119        "verification_attempts": [
120          {
121            "text": "Hello, how are you?",
122            "date_unix": 1714204800,
123            "accepted": true,
124            "similarity": 0.95,
125            "levenshtein_distance": 2,
126            "recording": {
127              "recording_id": "CwhRBWXzGAHq8TQ4Fs17",
128              "mime_type": "audio/mpeg",
129              "size_bytes": 1000000,
130              "upload_date_unix": 1714204800,
131              "transcription": "Hello, how are you?"
132            }
133          }
134        ]
135      },
136      "is_owner": false,
137      "is_legacy": false,
138      "is_mixed": false
139    }
140  ]
141}
Returns a list of all available voices for a user. Stops working once the user's workspace exceeds 500 voices.
Was this page helpful?
Previous

Voice design

Next
Built with

Headers

xi-api-keystringOptional

Query parameters

show_legacyboolean or nullOptionalDefaults to false

If set to true, legacy premade voices will be included in responses from /v1/voices

Response

Successful Response
voiceslist of objects
A list of available voices.

Errors

422
Unprocessable Entity Error