Get voice

GET

/v1/voices/:voice_id

GET

/v1/voices/:voice_id

1 curl https://api.elevenlabs.io/v1/voices/21m00Tcm4TlvDq8ikWAM

Try it

200Retrieved

1 {
2   "voice_id": "21m00Tcm4TlvDq8ikWAM",
3   "name": "Rachel",
4   "samples": [
5     {
6       "sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
7       "file_name": "sample.mp3",
8       "mime_type": "audio/mpeg",
9       "size_bytes": 1000000,
10       "hash": "1234567890",
11       "duration_secs": 1.1,
12       "remove_background_noise": true,
13       "has_isolated_audio": true,
14       "has_isolated_audio_preview": true,
15       "speaker_separation": {
16         "voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
17         "sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
18         "status": "not_started"
19       },
20       "trim_start": 1,
21       "trim_end": 1
22     }
23   ],
24   "category": "professional",
25   "fine_tuning": {
26     "is_allowed_to_fine_tune": true,
27     "state": {
28       "eleven_multilingual_v2": "fine_tuned"
29     },
30     "verification_failures": [
31       "verification_failures"
32     ],
33     "verification_attempts_count": 2,
34     "manual_verification_requested": false,
35     "language": "language",
36     "progress": {
37       "key": 1.1
38     },
39     "message": {
40       "key": "value"
41     },
42     "dataset_duration_seconds": 1.1,
43     "verification_attempts": [
44       {
45         "text": "Hello, how are you?",
46         "date_unix": 1714204800,
47         "accepted": true,
48         "similarity": 0.95,
49         "levenshtein_distance": 2,
50         "recording": {
51           "recording_id": "CwhRBWXzGAHq8TQ4Fs17",
52           "mime_type": "audio/mpeg",
53           "size_bytes": 1000000,
54           "upload_date_unix": 1714204800,
55           "transcription": "Hello, how are you?"
56         }
57       }
58     ],
59     "slice_ids": [
60       "slice_ids"
61     ],
62     "manual_verification": {
63       "extra_text": "Please verify the voice is that of a female.",
64       "request_time_unix": 1714204800,
65       "files": [
66         {
67           "file_id": "CwhRBWXzGAHq8TQ4Fs18",
68           "file_name": "file.mp3",
69           "mime_type": "audio/mpeg",
70           "size_bytes": 1000000,
71           "upload_date_unix": 1714204800
72         }
73       ]
74     },
75     "max_verification_attempts": 1,
76     "next_max_verification_attempts_reset_unix_ms": 1,
77     "finetuning_state": {
78       "key": "value"
79     }
80   },
81   "labels": {
82     "accent": "American",
83     "age": "middle-aged",
84     "description": "expressive",
85     "gender": "female",
86     "use_case": "social media"
87   },
88   "description": "A warm, expressive voice with a touch of humor.",
89   "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3",
90   "available_for_tiers": [
91     "creator",
92     "enterprise"
93   ],
94   "settings": {
95     "stability": 1,
96     "similarity_boost": 1,
97     "style": 0,
98     "use_speaker_boost": true,
99     "speed": 1
100   },
101   "sharing": {
102     "status": "enabled",
103     "history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
104     "date_unix": 1714204800,
105     "whitelisted_emails": [
106       "example@example.com"
107     ],
108     "public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18",
109     "original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
110     "financial_rewards_enabled": true,
111     "free_users_allowed": true,
112     "live_moderation_enabled": true,
113     "rate": 0.05,
114     "notice_period": 30,
115     "disable_at_unix": 1714204800,
116     "voice_mixing_allowed": false,
117     "featured": true,
118     "category": "professional",
119     "reader_app_enabled": true,
120     "image_url": "image_url",
121     "ban_reason": "ban_reason",
122     "liked_by_count": 100,
123     "cloned_by_count": 50,
124     "name": "Rachel",
125     "description": "A female voice with a soft and friendly tone.",
126     "labels": {
127       "accent": "American",
128       "gender": "female"
129     },
130     "review_status": "allowed",
131     "review_message": "review_message",
132     "enabled_in_library": true,
133     "instagram_username": "instagram_username",
134     "twitter_username": "twitter_username",
135     "youtube_username": "youtube_username",
136     "tiktok_username": "tiktok_username",
137     "moderation_check": {
138       "date_checked_unix": 1714204800,
139       "name_value": "Rachel",
140       "name_check": true,
141       "description_value": "A female voice with a soft and friendly tone.",
142       "description_check": true,
143       "sample_ids": [
144         "sample1",
145         "sample2"
146       ],
147       "sample_checks": [
148         0.95,
149         0.98
150       ],
151       "captcha_ids": [
152         "captcha1",
153         "captcha2"
154       ],
155       "captcha_checks": [
156         0.95,
157         0.98
158       ]
159     },
160     "reader_restricted_on": [
161       {
162         "resource_type": "read",
163         "resource_id": "FCwhRBWXzGAHq8TQ4Fs18"
164       }
165     ]
166   },
167   "high_quality_base_model_ids": [
168     "eleven_v2_flash",
169     "eleven_flash_v2",
170     "eleven_turbo_v2_5",
171     "eleven_multilingual_v2",
172     "eleven_v2_5_flash",
173     "eleven_flash_v2_5",
174     "eleven_turbo_v2"
175   ],
176   "verified_languages": [
177     {
178       "language": "en",
179       "model_id": "eleven_turbo_v2_5",
180       "accent": "American",
181       "locale": "locale",
182       "preview_url": "preview_url"
183     }
184   ],
185   "safety_control": "NONE",
186   "voice_verification": {
187     "requires_verification": false,
188     "is_verified": true,
189     "verification_failures": [
190       "verification_failures"
191     ],
192     "verification_attempts_count": 0,
193     "language": "en",
194     "verification_attempts": [
195       {
196         "text": "Hello, how are you?",
197         "date_unix": 1714204800,
198         "accepted": true,
199         "similarity": 0.95,
200         "levenshtein_distance": 2,
201         "recording": {
202           "recording_id": "CwhRBWXzGAHq8TQ4Fs17",
203           "mime_type": "audio/mpeg",
204           "size_bytes": 1000000,
205           "upload_date_unix": 1714204800,
206           "transcription": "Hello, how are you?"
207         }
208       }
209     ]
210   },
211   "permission_on_resource": "permission_on_resource",
212   "is_owner": false,
213   "is_legacy": false,
214   "is_mixed": false,
215   "created_at_unix": 1
216 }

Returns metadata about a specific voice.

Path parameters

voice_idstringRequired

ID of the voice to be used. You can use the Get voices endpoint list all the available voices.

Query parameters

with_settingsbooleanOptionalDefaults to trueDeprecated

This parameter is now deprecated. It is ignored and will be removed in a future version.

Response

Successful Response

voice_idstring

The ID of the voice.

namestringOptional

The name of the voice.

sampleslist of objectsOptional

List of samples associated with the voice.

categoryenumOptional

The category of the voice.

fine_tuningobjectOptional

Fine-tuning information for the voice.

labelsmap from strings to stringsOptional

Labels associated with the voice.

descriptionstringOptional

The description of the voice.

preview_urlstringOptional

The preview URL of the voice.

available_for_tierslist of stringsOptional

The tiers the voice is available for.

settingsobjectOptional

The settings of the voice.

high_quality_base_model_idslist of stringsOptional

The base model IDs for high-quality voices.

verified_languageslist of objectsOptional

The verified languages of the voice.

safety_controlenumOptional

The safety controls of the voice.

voice_verificationobjectOptional

The voice verification of the voice.

permission_on_resourcestringOptional

The permission on the resource of the voice.

is_ownerbooleanOptional

Whether the voice is owned by the user.

is_legacybooleanOptionalDefaults to false

Whether the voice is legacy.

is_mixedbooleanOptionalDefaults to false

Whether the voice is mixed.

created_at_unixintegerOptional

The creation time of the voice in Unix time.

Get voice

Path parameters

Headers

Query parameters

Response

Errors