Get History

Get History

Retrieve a list of your text-to-speech generation history.

Request

curl -X GET "https://api.elevenlabs8.com/api/elevenlabs-histories/" \
  -H "X-API-KEY: your_api_key_here"

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
limit	integer	No	Items per page (default: 20, max: 100)
status	string	No	Filter by status (completed, processing, failed)
model	string	No	Filter by model ID
voice	string	No	Filter by voice ID

Response

Response

{
  "success": true,
  "data": {
    "results": [
      {
        "id": "history_id_123",
        "user": {
          "fullname": "John Doe",
          "avatar": "https://api.elevenlabs8.com/media/avatars/john.jpg"
        },
        "history_id": "unique_history_id",
        "prompt": "Hello, this is a test message.",
        "model": "eleven_v3",
        "voice": "Rachel",
        "config": {
          "stability": 0.5,
          "similarity_boost": 0.75,
          "style": 0.0,
          "use_speaker_boost": true
        },
        "credits_used": 1,
        "status": "completed",
        "shared_url": "https://ttslab.com/share/audio_id",
        "created_at": "2024-01-01T12:00:00Z",
        "audio_url": "https://api.elevenlabs8.com/media/audio/output.mp3"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "pages": 8
    }
  },
  "message": "History retrieved successfully"
}

Get History Item

Retrieve details of a specific history item.

Request

curl -X GET "https://api.elevenlabs8.com/api/elevenlabs-histories/elevenlabs-histories_id_123" \
  -H "X-API-KEY: your_api_key_here"

Response

Response

{
  "success": true,
  "data": {
    "id": "history_id_123",
    "user": {
      "fullname": "John Doe",
      "avatar": "https://api.elevenlabs8.com/media/avatars/john.jpg"
    },
    "history_id": "unique_history_id",
    "prompt": "Hello, this is a test message.",
    "model": "eleven_v3",
    "voice": "Rachel",
    "config": {
      "stability": 0.5,
      "similarity_boost": 0.75,
      "style": 0.0,
      "use_speaker_boost": true
    },
    "credits_used": 1,
    "status": "completed",
    "shared_url": "https://ttslab.com/share/audio_id",
    "created_at": "2024-01-01T12:00:00Z",
    "audio_url": "https://api.elevenlabs8.com/media/audio/output.mp3",
    "duration": 3.5,
    "file_size": 52428
  },
  "message": "History item retrieved successfully"
}

History Properties

Property	Type	Description
id	string	Unique history identifier
user	object	User information
history_id	string	History tracking ID
prompt	string	The text that was converted to speech
model	string	Model used for generation
voice	string	Voice used for generation
config	object	Configuration parameters used
credits_used	integer	Number of credits consumed
status	string	Status of the generation
shared_url	string	Public shareable URL
created_at	string	Creation timestamp
audio_url	string	Direct URL to download audio
duration	float	Audio duration in seconds
file_size	integer	Audio file size in bytes

Status Values

Status	Description
completed	Generation completed successfully
processing	Generation is in progress
failed	Generation failed
cancelled	Generation was cancelled