Get voice

GET

/v1/voices/:voice_id

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

namestringOptional

sampleslist of objectsOptional

categoryenumOptional

fine_tuningobjectOptional

labelsmap from strings to stringsOptional

descriptionstringOptional

preview_urlstringOptional

available_for_tierslist of stringsOptional

settingsobjectOptional

high_quality_base_model_idslist of stringsOptional

safety_controlenumOptional

voice_verificationobjectOptional

permission_on_resourcestringOptional

is_ownerbooleanOptional

is_legacybooleanOptionalDefaults to false

is_mixedbooleanOptionalDefaults to false

created_at_unixintegerOptional

Errors

GET

1 curl https://api.elevenlabs.io/v1/voices/JBFqnCBsd6RMkjVDRZzb \
2      -H "xi-api-key: <apiKey>"

200Retrieved

1 {
2   "voice_id": "29vD33N1CtxCmqQRPOHJ",
3   "name": "Drew",
4   "samples": null,
5   "category": "premade",
6   "fine_tuning": {
7     "is_allowed_to_fine_tune": true,
8     "verification_failures": [],
9     "verification_attempts_count": 0,
10     "manual_verification_requested": false,
11     "language": "en",
12     "message": null,
13     "dataset_duration_seconds": null,
14     "verification_attempts": null,
15     "slice_ids": null,
16     "manual_verification": null,
17     "finetuning_state": "fine_tuned"
18   },
19   "labels": {
20     "accent": "american",
21     "description": "well-rounded",
22     "age": "middle aged",
23     "gender": "male",
24     "use_case": "news"
25   },
26   "description": null,
27   "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/29vD33N1CtxCmqQRPOHJ/e8b52a3f-9732-440f-b78a-16d5e26407a1.mp3",
28   "available_for_tiers": [],
29   "settings": {
30     "stability": 0.5,
31     "similarity_boost": 0.75,
32     "style": 0,
33     "use_speaker_boost": true
34   },
35   "sharing": null,
36   "high_quality_base_model_ids": [
37     "eleven_turbo_v2"
38   ],
39   "safety_control": null,
40   "voice_verification": {
41     "requires_verification": false,
42     "is_verified": false,
43     "verification_failures": [],
44     "verification_attempts_count": 0,
45     "language": null,
46     "verification_attempts": null
47   },
48   "permission_on_resource": null,
49   "is_owner": null,
50   "is_legacy": false,
51   "is_mixed": false,
52   "created_at_unix": 1234567890
53 }

Delete voice

Up Next

Built with

1	curl https://api.elevenlabs.io/v1/voices/JBFqnCBsd6RMkjVDRZzb \
2	-H "xi-api-key: <apiKey>"

1	{
2	"voice_id": "29vD33N1CtxCmqQRPOHJ",
3	"name": "Drew",
4	"samples": null,
5	"category": "premade",
6	"fine_tuning": {
7	"is_allowed_to_fine_tune": true,
8	"verification_failures": [],
9	"verification_attempts_count": 0,
10	"manual_verification_requested": false,
11	"language": "en",
12	"message": null,
13	"dataset_duration_seconds": null,
14	"verification_attempts": null,
15	"slice_ids": null,
16	"manual_verification": null,
17	"finetuning_state": "fine_tuned"
18	},
19	"labels": {
20	"accent": "american",
21	"description": "well-rounded",
22	"age": "middle aged",
23	"gender": "male",
24	"use_case": "news"
25	},
26	"description": null,
27	"preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/29vD33N1CtxCmqQRPOHJ/e8b52a3f-9732-440f-b78a-16d5e26407a1.mp3",
28	"available_for_tiers": [],
29	"settings": {
30	"stability": 0.5,
31	"similarity_boost": 0.75,
32	"style": 0,
33	"use_speaker_boost": true
34	},
35	"sharing": null,
36	"high_quality_base_model_ids": [
37	"eleven_turbo_v2"
38	],
39	"safety_control": null,
40	"voice_verification": {
41	"requires_verification": false,
42	"is_verified": false,
43	"verification_failures": [],
44	"verification_attempts_count": 0,
45	"language": null,
46	"verification_attempts": null
47	},
48	"permission_on_resource": null,
49	"is_owner": null,
50	"is_legacy": false,
51	"is_mixed": false,
52	"created_at_unix": 1234567890
53	}