Get Generated Items

GET

/v1/history

Returns metadata about all your generated audio.

Query parameters

page_sizeintegerOptional

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

Voice ID to be filtered for, you can use GET https://api.elevenlabs.io/v1/voices to receive a list of voices and their IDs.

searchstringOptional

search term used for filtering

source"TTS" or "STS"Optional

Source of the generated history item

Allowed values: TTSSTS

Response

Successful Response

historylist of objects

last_history_item_idstring

has_moreboolean

GET

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

200Retrieved

1 {
2   "history": [
3     {
4       "history_item_id": "ja9xsmfGhxYcymxGcOGB",
5       "request_id": "BF0BZg4IwLGBlaVjv9Im",
6       "voice_id": "21m00Tcm4TlvDq8ikWAM",
7       "model_id": "eleven_multilingual_v2",
8       "voice_name": "Rachel",
9       "voice_category": "premade",
10       "text": "This is an example sentence with streaming",
11       "date_unix": 1714650306,
12       "character_count_change_from": 17189,
13       "character_count_change_to": 17231,
14       "content_type": "audio/mpeg",
15       "state": "created",
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   "last_history_item_id": "ja9xsmfGhxYcymxGcOGB",
26   "has_more": true
27 }

Get History Item By Id

Up Next

Built with

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

1	{
2	"history": [
3	{
4	"history_item_id": "ja9xsmfGhxYcymxGcOGB",
5	"request_id": "BF0BZg4IwLGBlaVjv9Im",
6	"voice_id": "21m00Tcm4TlvDq8ikWAM",
7	"model_id": "eleven_multilingual_v2",
8	"voice_name": "Rachel",
9	"voice_category": "premade",
10	"text": "This is an example sentence with streaming",
11	"date_unix": 1714650306,
12	"character_count_change_from": 17189,
13	"character_count_change_to": 17231,
14	"content_type": "audio/mpeg",
15	"state": "created",
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	"last_history_item_id": "ja9xsmfGhxYcymxGcOGB",
26	"has_more": true
27	}