GET
/
v1
/
voices
/
{voice_id}
curl --request GET \
  --url https://api.elevenlabs.io/v1/voices/{voice_id}
{
  "voice_id": "<string>",
  "name": "<string>",
  "samples": [
    {
      "sample_id": "<string>",
      "file_name": "<string>",
      "mime_type": "<string>",
      "size_bytes": 123,
      "hash": "<string>"
    }
  ],
  "category": "<string>",
  "fine_tuning": {
    "is_allowed_to_fine_tune": true,
    "finetuning_state": "not_started",
    "verification_failures": [
      "<string>"
    ],
    "verification_attempts_count": 123,
    "manual_verification_requested": true,
    "language": "<string>",
    "finetuning_progress": {},
    "message": "<string>",
    "dataset_duration_seconds": 123,
    "verification_attempts": [
      {
        "text": "<string>",
        "date_unix": 123,
        "accepted": true,
        "similarity": 123,
        "levenshtein_distance": 123,
        "recording": {
          "recording_id": "<string>",
          "mime_type": "<string>",
          "size_bytes": 123,
          "upload_date_unix": 123,
          "transcription": "<string>"
        }
      }
    ],
    "slice_ids": [
      "<string>"
    ],
    "manual_verification": {
      "extra_text": "<string>",
      "request_time_unix": 123,
      "files": [
        {
          "file_id": "<string>",
          "file_name": "<string>",
          "mime_type": "<string>",
          "size_bytes": 123,
          "upload_date_unix": 123
        }
      ]
    }
  },
  "labels": {},
  "description": "<string>",
  "preview_url": "<string>",
  "available_for_tiers": [
    "<string>"
  ],
  "settings": {
    "stability": 123,
    "similarity_boost": 123,
    "style": 123,
    "use_speaker_boost": true
  },
  "sharing": {
    "status": "enabled",
    "history_item_sample_id": "<string>",
    "date_unix": 123,
    "whitelisted_emails": [
      "<string>"
    ],
    "public_owner_id": "<string>",
    "original_voice_id": "<string>",
    "financial_rewards_enabled": true,
    "free_users_allowed": true,
    "live_moderation_enabled": true,
    "rate": 123,
    "notice_period": 123,
    "disable_at_unix": 123,
    "voice_mixing_allowed": true,
    "featured": true,
    "category": "generated",
    "reader_app_enabled": true,
    "ban_reason": "<string>",
    "liked_by_count": 123,
    "cloned_by_count": 123,
    "name": "<string>",
    "description": "<string>",
    "labels": {},
    "review_status": "not_requested",
    "review_message": "<string>",
    "enabled_in_library": true,
    "instagram_username": "<string>",
    "twitter_username": "<string>",
    "youtube_username": "<string>",
    "tiktok_username": "<string>"
  },
  "high_quality_base_model_ids": [
    "<string>"
  ],
  "safety_control": "NONE",
  "voice_verification": {
    "requires_verification": true,
    "is_verified": true,
    "verification_failures": [
      "<string>"
    ],
    "verification_attempts_count": 123,
    "language": "<string>",
    "verification_attempts": [
      {
        "text": "<string>",
        "date_unix": 123,
        "accepted": true,
        "similarity": 123,
        "levenshtein_distance": 123,
        "recording": {
          "recording_id": "<string>",
          "mime_type": "<string>",
          "size_bytes": 123,
          "upload_date_unix": 123,
          "transcription": "<string>"
        }
      }
    ]
  },
  "owner_id": "<string>",
  "permission_on_resource": "<string>"
}

Headers

xi-api-key
string

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

Path Parameters

voice_id
string
required

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

Query Parameters

with_settings
boolean
default: false

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

Response

200 - application/json
voice_id
string
required
name
string
required
samples
object[]
required
category
string
required
fine_tuning
object
required
labels
object
required
description
string
required
preview_url
string
required
available_for_tiers
string[]
required
settings
object
required
sharing
object
required
high_quality_base_model_ids
string[]
required
safety_control
enum<string>
Available options:
NONE,
BAN,
CAPTCHA,
CAPTCHA_AND_MODERATION
voice_verification
object
owner_id
string
permission_on_resource
string
Get Voice SettingsDelete Voice