v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Get TTS history

Retrieve a single TTS history entry by ID.

get/v2/tts/histories/{id}

Path parameters

idstring uuid required

Example:48f7656f-098b-4c43-b165-7cfd2cc8ac30

History identifier.

Query parameters

projectIdstring required

Example:ae6d58c6-c6bd-4ae0-ad74-b8b39c29928b

Project identifier.

Response

History retrieved successfully.

successboolean

messagestring

messageKeystring

Example response

{
  "success": true,
  "message": "Operation completed successfully",
  "messageKey": "OPERATION_SUCCESSFUL",
  "data": {
    "id": "c4f66d94-a1f5-4000-b9a3-dad55b206968",
    "audio": "https://cdn.tryhamsa.com/tts-histories/audio.wav",
    "downloadUrl": "https://cdn.tryhamsa.com/tts-histories/audio.wav?response-content-disposition=attachment",
    "script": "hello hello",
    "createdAt": "2025-12-31T08:19:52.129Z",
    "ttsVoice": {
      "name": "Huda",
      "dialect": {
        "languageCode": "oma",
        "language": "ar"
      }
    }
  }
}