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) or STT (speech to text).

Allowed values:

alignmentsobjectOptional

The alignments of the history item.

Path parameters

Headers

Response

Errors