Get history item | ElevenLabs Documentation

1 curl https://api.elevenlabs.io/v1/history/VW7YKqPnjY4h39yTbx2L \ 2 -H "xi-api-key: <apiKey>"

1 { 2 "history_item_id": "ja9xsmfGhxYcymxGcOGB", 3 "voice_id": "21m00Tcm4TlvDq8ikWAM", 4 "voice_name": "Rachel", 5 "text": "Hello, world!", 6 "date_unix": 1714650306, 7 "character_count_change_from": 17189, 8 "character_count_change_to": 17231, 9 "content_type": "audio/mpeg", 10 "state": "created", 11 "request_id": "BF0BZg4IwLGBlaVjv9Im", 12 "model_id": "eleven_multilingual_v2", 13 "voice_category": "premade", 14 "settings": { 15 "similarity_boost": 0.5, 16 "stability": 0.71, 17 "style": 0, 18 "use_speaker_boost": true 19 }, 20 "feedback": { 21 "thumbs_up": true, 22 "feedback": "This is an example of test feedback.", 23 "emotions": true, 24 "inaccurate_clone": false, 25 "glitches": true, 26 "audio_quality": true, 27 "other": false, 28 "review_status": "not_reviewed" 29 }, 30 "share_link_id": "share_link_id", 31 "source": "TTS", 32 "alignments": { 33 "alignment": { 34 "characters": [ 35 "characters" 36 ], 37 "character_start_times_seconds": [ 38 1.1 39 ], 40 "character_end_times_seconds": [ 41 1.1 42 ] 43 }, 44 "normalized_alignment": { 45 "characters": [ 46 "characters" 47 ], 48 "character_start_times_seconds": [ 49 1.1 50 ], 51 "character_end_times_seconds": [ 52 1.1 53 ] 54 } 55 } 56 }

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-keystringRequired

Response

Successful Response

history_item_idstring

The ID of the history item.

voice_idstring

The ID of the voice used.

voice_namestring

The name of the voice.

textstring

The text used to generate the audio 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.

stateenum

The state of the history item.

Allowed values:

request_idstringOptional

The ID of the request.

model_idstringOptional

The ID of the model.

voice_categoryenumOptional

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

Allowed values:

settingsmap from strings to anyOptional

The settings of the history item.

feedbackobjectOptional

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

share_link_idstringOptional

The ID of the share link.

sourceenumOptional

The source of the history item. Either TTS (text to speech), STS (speech to text), AN (audio native), Projects, Dubbing or PlayAPI.

alignmentsobjectOptional

The alignments of the history item.

Path parameters

Headers

Response

Errors