curl -X GET 'https://api.elevenlabs.io/v1/history?page_size=100&start_after_history_item_id=start-after-history-item-id&voice_id=voice-id&model_id=model-id&date_before_unix=10&date_after_unix=10&sort_direction=desc&search=example-search&source=TTS' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/history (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> List Generated Items

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X GET 'https://api.elevenlabs.io/v1/history?page_size=100&start_after_history_item_id=start-after-history-item-id&voice_id=voice-id&model_id=model-id&date_before_unix=10&date_after_unix=10&sort_direction=desc&search=example-search&source=TTS' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| page_size | query | integer | No | How many history items to return at m... |
| start_after_history_item_id | query | string | No | After which ID to start fetching, use... |
| voice_id | query | string | No | Voice ID to be filtered for, you can... |

## Response (200 OK)
{"has_more":true,"history":[{}]}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

GET

/v1/history

ElevenLabs API

List Generated Items

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 208 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/history?page_size=100&start_after_history_item_id=start-after-history-item-id&voice_id=voice-id&model_id=model-id&date_before_unix=10&date_after_unix=10&sort_direction=desc&search=example-search&source=TTS' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
page_size	query	integer	No	How many history items to return at maximum. Can not exceed 1000, defaults to 100.
start_after_history_item_id	query	string	No	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	query	string	No	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.
model_id	query	string	No	Model ID to filter history items by.
date_before_unix	query	integer	No	Unix timestamp to filter history items before this date (exclusive).
date_after_unix	query	integer	No	Unix timestamp to filter history items after this date (inclusive).
sort_direction	query	string	No	Sort direction for the results.
search	query	string	No	search term used for filtering
source	query	string	No	Source of the generated history item

Response 200 OK

{
  "has_more": true,
  "history": [
    {
      "character_count_change_from": 17189,
      "character_count_change_to": 17231,
      "content_type": "audio/mpeg",
      "date_unix": 1714650306,
      "history_item_id": "ja9xsmfGhxYcymxGcOGB",
      "model_id": "eleven_multilingual_v2",
      "request_id": "BF0BZg4IwLGBlaVjv9Im",
      "settings": {
        "similarity_boost": 0.5,
        "stability": 0.71,
        "style": 0,
        "use_speaker_boost": true
      },
      "source": "TTS",
      "state": "created",
      "text": "Hello, world!",
      "voice_category": "premade",
      "voice_id": "21m00Tcm4TlvDq8ikWAM",
      "voice_name": "Rachel"
    }
  ],
  "last_history_item_id": "ja9xsmfGhxYcymxGcOGB",
  "scanned_until": 1714650306
}