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
      • GETList voices
      • GETGet voice
      • DELDelete voice
      • POSTEdit voice
      • POSTList similar voices
  • ElevenCreative
  • Core Resources
  • Workspace
  • Legacy
LogoLogo
Login
Login
Connect
BlogHelp CenterAPI PricingSign up
ElevenAPIVoices

Get voice

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

Delete voice

Next
Built with

Path parameters

voice_idstringRequired

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

Headers

xi-api-keystringOptional

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.
namestring
The name of the voice.
sampleslist of objects or null
List of samples associated with the voice.
categoryenum
The category of the voice.
fine_tuningobject or null

Fine-tuning information for the voice.

labelsmap from strings to strings
Labels associated with the voice.
descriptionstring or null
The description of the voice.
preview_urlstring or null
The preview URL of the voice.
available_for_tierslist of strings
The tiers the voice is available for.
settingsobject or null
The settings of the voice.
sharingobject or null
The sharing information of the voice.
high_quality_base_model_idslist of strings

The base model IDs for high-quality voices.

verified_languageslist of objects or null
The verified languages of the voice.
collection_idslist of strings or null
The IDs of collections this voice belongs to.
safety_controlenum or null
The safety controls of the voice.
Allowed values:
voice_verificationobject or null
The voice verification of the voice.
permission_on_resourcestring or null
The permission on the resource of the voice.
is_ownerboolean or null
Whether the voice is owned by the user.
is_legacybooleanDefaults to false
Whether the voice is legacy.
is_mixedbooleanDefaults to false
Whether the voice is mixed.
favorited_at_unixinteger or null
Timestamp when the voice was marked as favorite in Unix time.
created_at_unixinteger or null
The creation time of the voice in Unix time.
is_bookmarkedboolean or null

Whether the voice is bookmarked by the current user. Only relevant for community (library-copied) voices.

recording_qualityenum or null
The recording quality of the voice as determined by the review pipeline.
Allowed values:
labelling_statusenum or null
The review pipeline status of the voice.
Allowed values:
recording_quality_reasonstring or null
The reason for the recording quality assessment, as determined by the review pipeline.

Errors

422
Unprocessable Entity Error