---
title: "List Generated Items"
method: GET
path: "/v1/history"
tags: ["speech-history"]
---

# List Generated Items

`GET /v1/history`

Returns a list of your generated audio (e.g. text to speech, speech to speech, Studio, dubbing). Music and SFX generations are not included and cannot currently be retrieved via the API.

## Query parameters

- `page_size` integer — How many history items to return at maximum. Can not exceed 1000, defaults to 100.
- `start_after_history_item_id` string, nullable — 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, nullable — 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` string, nullable — Model ID to filter history items by.
- `date_before_unix` integer, nullable — Unix timestamp to filter history items before this date (exclusive).
- `date_after_unix` integer, nullable — Unix timestamp to filter history items after this date (inclusive).
- `sort_direction` 'asc' | 'desc', nullable — Sort direction for the results.
- `search` string, nullable — search term used for filtering
- `source` 'TTS' | 'STS' | 'Flows', nullable — Source of the generated history item

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetSpeechHistoryResponseModel
  - `history` SpeechHistoryItemResponseModel[], required — A list of speech history items.
    - `history_item_id` string, required — The ID of the history item.
    - `request_id` string, nullable — The ID of the request.
    - `voice_id` string, nullable — The ID of the voice used.
    - `model_id` string, nullable — The ID of the model.
    - `voice_name` string, nullable — The name of the voice.
    - `voice_category` 'premade' | 'cloned' | 'generated' | 'professional', nullable — The category of the voice. Either 'premade', 'cloned', 'generated' or 'professional'.
    - `text` string, nullable — The text used to generate the audio item.
    - `date_unix` integer, required — Unix timestamp of when the item was created.
    - `character_count_change_from` integer, required — The character count change from.
    - `character_count_change_to` integer, required — The character count change to.
    - `content_type` string, required — The content type of the generated item.
    - `state` 'created' | 'deleted' | 'processing', required — The state of the history item.
    - `settings` object, nullable — The settings of the history item.
    - `share_link_id` string, nullable — The ID of the share link.
    - `source` 'TTS' | 'STS' | 'Projects' | 'PD' | 'AN' | 'Dubbing' | 'PlayAPI' | 'ConvAI' | 'VoiceGeneration' | 'InVPC' | 'Flows', nullable — The source of the history item. Either TTS (text to speech), STS (speech to text), AN (audio native), Projects, Dubbing, PlayAPI, PD (pronunciation dictionary) or ConvAI (Agents Platform).
    - `alignments` HistoryAlignmentsResponseModel
      - `alignment` HistoryAlignmentResponseModel, required
        - `characters` string[], required — The characters in the alignment.
        - `character_start_times_seconds` number[], required — The start times of the characters in seconds.
        - `character_end_times_seconds` number[], required — The end times of the characters in seconds.
      - `normalized_alignment` HistoryAlignmentResponseModel, required
        - `characters` string[], required — The characters in the alignment.
        - `character_start_times_seconds` number[], required — The start times of the characters in seconds.
        - `character_end_times_seconds` number[], required — The end times of the characters in seconds.
    - `dialogue` DialogueInputResponseModel[], nullable — The dialogue (voice and text pairs) used to generate the audio item. If this is set then the top level `text` and `voice_id` fields will be empty.
      - `text` string, required — The text of the dialogue input line.
      - `voice_id` string, required — The ID of the voice used for this dialogue input line.
      - `voice_name` string, required — The name of the voice used for this dialogue input line.
    - `output_format` string, nullable — The output format the audio was originally generated in.
  - `last_history_item_id` string, nullable — The ID of the last history item.
  - `has_more` boolean, required — Whether there are more history items to fetch.
  - `scanned_until` integer, nullable — The timestamp of the last history item.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/e77a0a530a82/schema)