Get generated items

GET

/v1/history

Returns metadata about all your generated audio.

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 history items. If search parameter is provided, source becomes required. Otherwise this parameter is optional.

Allowed values: TTSSTS

Response

Successful Response

historylist of objects

last_history_item_idstring

has_moreboolean

Errors

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       "feedback": null,
23       "share_link_id": null,
24       "source": "TTS"
25     }
26   ],
27   "last_history_item_id": "ja9xsmfGhxYcymxGcOGB",
28   "has_more": true
29 }

Get history item

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	"feedback": null,
23	"share_link_id": null,
24	"source": "TTS"
25	}
26	],
27	"last_history_item_id": "ja9xsmfGhxYcymxGcOGB",
28	"has_more": true
29	}