Get Voice

GET

/v1/voices/:voice_id

Returns metadata about a specific voice.

Path parameters

voice_idstringRequired

Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.

Query parameters

with_settingsbooleanOptional

If set will return settings information corresponding to the voice, requires authorization.

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_legacybooleanOptional

is_mixedbooleanOptional

created_at_unixintegerOptional

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   "category": "premade",
5   "fine_tuning": {
6     "is_allowed_to_fine_tune": true,
7     "verification_failures": [],
8     "verification_attempts_count": 0,
9     "manual_verification_requested": false,
10     "language": "en",
11     "finetuning_state": "fine_tuned"
12   },
13   "labels": {
14     "accent": "american",
15     "description": "well-rounded",
16     "age": "middle aged",
17     "gender": "male",
18     "use_case": "news"
19   },
20   "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/29vD33N1CtxCmqQRPOHJ/e8b52a3f-9732-440f-b78a-16d5e26407a1.mp3",
21   "available_for_tiers": [],
22   "settings": {
23     "stability": 0.5,
24     "similarity_boost": 0.75,
25     "style": 0,
26     "use_speaker_boost": true
27   },
28   "high_quality_base_model_ids": [
29     "eleven_turbo_v2"
30   ],
31   "voice_verification": {
32     "requires_verification": false,
33     "is_verified": false,
34     "verification_failures": [],
35     "verification_attempts_count": 0
36   }
37 }

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	"category": "premade",
5	"fine_tuning": {
6	"is_allowed_to_fine_tune": true,
7	"verification_failures": [],
8	"verification_attempts_count": 0,
9	"manual_verification_requested": false,
10	"language": "en",
11	"finetuning_state": "fine_tuned"
12	},
13	"labels": {
14	"accent": "american",
15	"description": "well-rounded",
16	"age": "middle aged",
17	"gender": "male",
18	"use_case": "news"
19	},
20	"preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/29vD33N1CtxCmqQRPOHJ/e8b52a3f-9732-440f-b78a-16d5e26407a1.mp3",
21	"available_for_tiers": [],
22	"settings": {
23	"stability": 0.5,
24	"similarity_boost": 0.75,
25	"style": 0,
26	"use_speaker_boost": true
27	},
28	"high_quality_base_model_ids": [
29	"eleven_turbo_v2"
30	],
31	"voice_verification": {
32	"requires_verification": false,
33	"is_verified": false,
34	"verification_failures": [],
35	"verification_attempts_count": 0
36	}
37	}