Skip to main content
GET
/
v1
/
history
/
{history_item_id}
Python
from elevenlabs import ElevenLabs

client = ElevenLabs(
    api_key="YOUR_API_KEY",
)
client.history.get(
    history_item_id="HISTORY_ITEM_ID",
)
{
  "history_item_id": "<string>",
  "request_id": "<string>",
  "voice_id": "<string>",
  "model_id": "<string>",
  "voice_name": "<string>",
  "voice_category": "premade",
  "text": "<string>",
  "date_unix": 123,
  "character_count_change_from": 123,
  "character_count_change_to": 123,
  "content_type": "<string>",
  "state": "created",
  "settings": {},
  "feedback": {
    "thumbs_up": true,
    "feedback": "<string>",
    "emotions": true,
    "inaccurate_clone": true,
    "glitches": true,
    "audio_quality": true,
    "other": true,
    "review_status": "not_reviewed"
  },
  "share_link_id": "<string>",
  "source": "TTS",
  "alignments": {
    "alignment": {
      "characters": [
        "<string>"
      ],
      "character_start_times_seconds": [
        123
      ],
      "character_end_times_seconds": [
        123
      ]
    },
    "normalized_alignment": {
      "characters": [
        "<string>"
      ],
      "character_start_times_seconds": [
        123
      ],
      "character_end_times_seconds": [
        123
      ]
    }
  }
}

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

​
history_item_id
string
required

History item ID to be used, you can use GET https://api.elevenlabs.io/v1/history to receive a list of history items and their IDs.

Response

Successful Response

​
history_item_id
string
required
​
request_id
string
required
​
voice_id
string
required
​
model_id
string
required
​
voice_name
string
required
​
voice_category
enum<string>
required
Available options:
premade,
cloned,
generated,
professional
​
text
string
required
​
date_unix
integer
required
​
character_count_change_from
integer
required
​
character_count_change_to
integer
required
​
content_type
string
required
​
state
enum<string>
required
Available options:
created,
deleted,
processing
​
settings
object
required
​
feedback
object
required
​
share_link_id
string
required
​
source
enum<string>
required
Available options:
TTS,
STS
​
alignments
object