List voices

GET

/v1/voices

GET

1 from elevenlabs import ElevenLabs
2 
3 client = ElevenLabs(
4     api_key="YOUR_API_KEY",
5 )
6 client.voices.get_all()

Try it

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

Returns a list of all available voices for a user.

Query parameters

show_legacybooleanOptional

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.

List voices

Headers

Query parameters

Response

Errors