Get generated items | ElevenLabs Documentation

1 from elevenlabs import ElevenLabs 2 3 client = ElevenLabs( 4 api_key="YOUR_API_KEY", 5 ) 6 client.history.list()

1 { 2 "history": [ 3 { 4 "history_item_id": "ja9xsmfGhxYcymxGcOGB", 5 "date_unix": 1714650306, 6 "character_count_change_from": 17189, 7 "character_count_change_to": 17231, 8 "content_type": "audio/mpeg", 9 "state": null, 10 "request_id": "BF0BZg4IwLGBlaVjv9Im", 11 "voice_id": "21m00Tcm4TlvDq8ikWAM", 12 "model_id": "eleven_multilingual_v2", 13 "voice_name": "Rachel", 14 "voice_category": "premade", 15 "text": "Hello, world!", 16 "settings": { 17 "similarity_boost": 0.5, 18 "stability": 0.71, 19 "style": 0, 20 "use_speaker_boost": true 21 }, 22 "source": "TTS" 23 } 24 ], 25 "has_more": true, 26 "last_history_item_id": "ja9xsmfGhxYcymxGcOGB" 27 }

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_idstring or nullOptional

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_idstring or nullOptional

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

searchstring or nullOptional

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

sourceenum or nullOptional

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_idstring or null

The ID of the last history item.

Headers

Query parameters

Response

Errors