Skip to main content
GET
/
v2
/
tts
/
histories
List TTS histories
curl --request GET \
  --url https://api.tryhamsa.com/v2/tts/histories \
  --header 'Authorization: <api-key>'
{
  "success": true,
  "message": "Operation completed successfully",
  "messageKey": "OPERATION_SUCCESSFUL",
  "data": {
    "ttsHistories": [
      {
        "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"
          }
        }
      }
    ],
    "totalPages": 5,
    "page": 1,
    "totalCount": 50
  }
}

Authorizations

​
Authorization
string
header
required

Pass the API key in the Authorization header, You need to put Token keyword before the API key. e.g. 'Authorization: Token '

Query Parameters

​
page
integer
required

Current page number.

Example:

1

​
perPage
integer
required

Number of items per page.

Example:

10

​
projectId
string
required

Project identifier.

Example:

"ae6d58c6-c6bd-4ae0-ad74-b8b39c29928b"

Response

Histories retrieved successfully.

​
success
boolean
Example:

true

​
message
string
Example:

"Operation completed successfully"

​
messageKey
string
Example:

"OPERATION_SUCCESSFUL"

​
data
object