v5

OpenAPI 3.1.02026-08-043621,4011.8 MB

voices

Get Voice

Returns metadata about a specific voice.

get/v1/voices/{voice_id}

Path parameters

voice_idstring required

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

Example:21m00Tcm4TlvDq8ikWAM

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

Query parameters

with_settingsboolean

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

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

voice_idstring required

The ID of the voice.

namestring required

The name of the voice.

The category of the voice.

labelsobject required

Labels associated with the voice.

descriptionstring nullable

The description of the voice.

preview_urlstring nullable

The preview URL of the voice.

available_for_tiersstring[] required

The tiers the voice is available for.

high_quality_base_model_idsstring[] required

The base model IDs for high-quality voices.

collection_idsstring[] nullable

The IDs of collections this voice belongs to.

safety_control'NONE' | 'BAN' | 'CAPTCHA' | 'ENTERPRISE_BAN' | 'ENTERPRISE_CAPTCHA' nullable

The safety controls of the voice.

permission_on_resourcestring nullable

The permission on the resource of the voice.

is_ownerboolean nullable

Whether the voice is owned by the user.

is_legacyboolean

Whether the voice is legacy.

is_mixedboolean

Whether the voice is mixed.

favorited_at_unixinteger nullable

Timestamp when the voice was marked as favorite in Unix time.

created_at_unixinteger nullable

The creation time of the voice in Unix time.

is_bookmarkedboolean nullable

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

recording_quality'studio' | 'good' | 'ok' | 'poor' | 'bad' nullable

The recording quality of the voice as determined by the review pipeline.

labelling_status'in_review' | 'review_complete' nullable

The review pipeline status of the voice.

recording_quality_reasonstring nullable

The reason for the recording quality assessment, as determined by the review pipeline.

Example response

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