Get history item | ElevenLabs Documentation

from elevenlabs import ElevenLabs
client = ElevenLabs()
client.history.get(
    history_item_id="VW7YKqPnjY4h39yTbx2L",
)

{
  "history_item_id": "ja9xsmfGhxYcymxGcOGB",
  "date_unix": 1714650306,
  "character_count_change_from": 17189,
  "character_count_change_to": 17231,
  "content_type": "audio/mpeg",
  "state": "created",
  "request_id": "BF0BZg4IwLGBlaVjv9Im",
  "voice_id": "21m00Tcm4TlvDq8ikWAM",
  "model_id": "eleven_multilingual_v2",
  "voice_name": "Rachel",
  "voice_category": "premade",
  "text": "Hello, world!",
  "settings": {
    "similarity_boost": 0.5,
    "stability": 0.71,
    "style": 0,
    "use_speaker_boost": true
  },
  "feedback": {
    "thumbs_up": true,
    "feedback": "This is an example of test feedback.",
    "emotions": true,
    "inaccurate_clone": false,
    "glitches": true,
    "audio_quality": true,
    "other": false,
    "review_status": "not_reviewed"
  },
  "share_link_id": "share_link_id",
  "source": "TTS",
  "alignments": {
    "alignment": {
      "characters": [
        "characters"
      ],
      "character_start_times_seconds": [
        1.1
      ],
      "character_end_times_seconds": [
        1.1
      ]
    },
    "normalized_alignment": {
      "characters": [
        "characters"
      ],
      "character_start_times_seconds": [
        1.1
      ],
      "character_end_times_seconds": [
        1.1
      ]
    }
  },
  "dialogue": [
    {
      "text": "text",
      "voice_id": "voice_id",
      "voice_name": "voice_name"
    }
  ],
  "output_format": "output_format"
}

Retrieves a history item.

Path parameters

history_item_idstringRequired

ID of the history item to be used. You can use the Get generated items endpoint to retrieve a list of history items.

Headers

xi-api-keystringOptional

Response

Successful Response

history_item_idstring

The ID of the history item.

date_unixinteger

Unix timestamp of when the item was created.

character_count_change_frominteger

The character count change from.

character_count_change_tointeger

The character count change to.

content_typestring

The content type of the generated item.

stateany

request_idstring

The ID of the request.

voice_idstring

The ID of the voice used.

model_idstring

The ID of the model.

voice_namestring

The name of the voice.

voice_categoryenum

The category of the voice. Either 'premade', 'cloned', 'generated' or 'professional'.

Allowed values:

textstring

The text used to generate the audio item.

settingsmap from strings to any

The settings of the history item.

feedbackobject

Feedback associated with the generated item. Returns null if no feedback has been provided.

share_link_idstring

The ID of the share link.

sourceenum

The source of the history item. Either TTS (text to speech), STS (speech to text), AN (audio native), Projects, Dubbing, PlayAPI, PD (pronunciation dictionary) or ConvAI (Agents Platform).

alignmentsobject

The alignments of the history item.

dialoguelist of objects

The dialogue (voice and text pairs) used to generate the audio item. If this is set then the top level text and voice_id fields will be empty.

output_formatstring

The output format the audio was originally generated in.

Errors

422

History Get Request Unprocessable Entity Error