GET
/
v1
/
history
curl --request GET \
  --url https://api.elevenlabs.io/v1/history
{
  "history": [
    {
      "history_item_id": "<string>",
      "request_id": "<string>",
      "voice_id": "<string>",
      "model_id": "<string>",
      "voice_name": "<string>",
      "voice_category": "premade",
      "text": "<string>",
      "date_unix": 123,
      "character_count_change_from": 123,
      "character_count_change_to": 123,
      "content_type": "<string>",
      "state": "created",
      "settings": {},
      "feedback": {
        "thumbs_up": true,
        "feedback": "<string>",
        "emotions": true,
        "inaccurate_clone": true,
        "glitches": true,
        "audio_quality": true,
        "other": true,
        "review_status": "not_reviewed"
      },
      "share_link_id": "<string>",
      "source": "TTS",
      "alignments": {
        "alignment": {
          "characters": [
            "<string>"
          ],
          "character_start_times_seconds": [
            123
          ],
          "character_end_times_seconds": [
            123
          ]
        },
        "normalized_alignment": {
          "characters": [
            "<string>"
          ],
          "character_start_times_seconds": [
            123
          ],
          "character_end_times_seconds": [
            123
          ]
        }
      }
    }
  ],
  "last_history_item_id": "<string>",
  "has_more": true
}

Headers

​
xi-api-key
string

Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.

Query Parameters

​
page_size
integer
default:100

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

​
start_after_history_item_id
string

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_id
string

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.

Response

200
application/json
Successful Response
​
history
object[]
required
​
last_history_item_id
string
required
​
has_more
boolean
required