Get voice | ElevenLabs Documentation

curl https://api.elevenlabs.io/v1/voices/voice_id \
     -H "xi-api-key: xi-api-key"

{
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "name": "Rachel",
  "category": "professional",
  "fine_tuning": {
    "is_allowed_to_fine_tune": true,
    "state": {
      "eleven_multilingual_v2": "fine_tuned"
    },
    "verification_failures": [],
    "verification_attempts_count": 2,
    "manual_verification_requested": false
  },
  "labels": {
    "accent": "American",
    "age": "middle-aged",
    "description": "expressive",
    "gender": "female",
    "use_case": "social media"
  },
  "description": "A warm, expressive voice with a touch of humor.",
  "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3",
  "available_for_tiers": [
    "creator",
    "enterprise"
  ],
  "settings": {
    "stability": 1,
    "use_speaker_boost": true,
    "similarity_boost": 1,
    "style": 0,
    "speed": 1
  },
  "sharing": {
    "status": "enabled",
    "history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
    "date_unix": 1714204800,
    "whitelisted_emails": [
      "example@example.com"
    ],
    "public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18",
    "original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
    "financial_rewards_enabled": true,
    "free_users_allowed": true,
    "live_moderation_enabled": true,
    "rate": 0.05,
    "notice_period": 30,
    "disable_at_unix": 1714204800,
    "voice_mixing_allowed": false,
    "featured": true,
    "category": "professional",
    "reader_app_enabled": true,
    "liked_by_count": 100,
    "cloned_by_count": 50,
    "name": "Rachel",
    "description": "A female voice with a soft and friendly tone.",
    "labels": {
      "accent": "American",
      "gender": "female"
    },
    "review_status": "allowed",
    "enabled_in_library": true,
    "moderation_check": {
      "date_checked_unix": 1714204800,
      "name_value": "Rachel",
      "name_check": true,
      "description_value": "A female voice with a soft and friendly tone.",
      "description_check": true,
      "sample_ids": [
        "sample1",
        "sample2"
      ],
      "sample_checks": [
        0.95,
        0.98
      ],
      "captcha_ids": [
        "captcha1",
        "captcha2"
      ],
      "captcha_checks": [
        0.95,
        0.98
      ]
    },
    "reader_restricted_on": [
      {
        "resource_type": "read",
        "resource_id": "FCwhRBWXzGAHq8TQ4Fs18"
      }
    ]
  },
  "high_quality_base_model_ids": [
    "eleven_v2_flash",
    "eleven_flash_v2",
    "eleven_turbo_v2_5",
    "eleven_multilingual_v2",
    "eleven_v2_5_flash",
    "eleven_flash_v2_5",
    "eleven_turbo_v2"
  ],
  "verified_languages": [
    {
      "language": "en",
      "model_id": "eleven_multilingual_v2",
      "accent": "american",
      "locale": "en-US",
      "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3"
    }
  ],
  "voice_verification": {
    "requires_verification": false,
    "is_verified": true,
    "verification_failures": [],
    "verification_attempts_count": 0,
    "language": "en",
    "verification_attempts": [
      {
        "text": "Hello, how are you?",
        "date_unix": 1714204800,
        "accepted": true,
        "similarity": 0.95,
        "levenshtein_distance": 2,
        "recording": {
          "recording_id": "CwhRBWXzGAHq8TQ4Fs17",
          "mime_type": "audio/mpeg",
          "size_bytes": 1000000,
          "upload_date_unix": 1714204800,
          "transcription": "Hello, how are you?"
        }
      }
    ]
  },
  "is_owner": false,
  "is_legacy": false,
  "is_mixed": false
}

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.

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.

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

Path parameters

Headers

Query parameters

Response

Errors