Get generated items | ElevenLabs Documentation

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

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

Returns a list of your generated audio.

Headers

xi-api-keystringRequired

Query parameters

page_sizeintegerOptionalDefaults to 100

How many history items to return at maximum. Can not exceed 1000, defaults to 100.

start_after_history_item_idstringOptional

After which ID to start fetching, use this parameter to paginate across a large collection of history items. In case this parameter is not provided history items will be fetched starting from the most recently created one ordered descending by their creation date.

voice_idstringOptional

ID of the voice to be filtered for. You can use the Get voices endpoint list all the available voices.

searchstringOptional

Search term used for filtering history items. If provided, source becomes required.

sourceenumOptional

Source of the generated history item

Allowed values:

Response

Successful Response

historylist of objects

A list of speech history items.

has_moreboolean

Whether there are more history items to fetch.

last_history_item_idstringOptional

The ID of the last history item.

Headers

Query parameters

Response

Errors