---
title: "Get TTS history"
method: GET
path: "/v2/tts/histories/{id}"
---

# Get TTS history

`GET /v2/tts/histories/{id}`

Retrieve a single TTS history entry by ID.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `projectId` string, required

## Response `200`

History retrieved successfully.

- GetTtsHistoryResponse
  - `success` boolean
  - `message` string
  - `messageKey` string
  - `data` TtsHistory
    - `id` string, uuid, required
    - `audio` string, uri, required — Signed URL for streaming the generated TTS audio
    - `downloadUrl` string, uri, required — Signed URL for downloading the generated TTS audio
    - `script` string, required — Original script used to generate the audio
    - `createdAt` string, date-time, required
    - `ttsVoice` object, required
      - `name` string, required
      - `dialect` object, nullable
        - `languageCode` string
        - `language` 'ar' | 'en'

## Other responses

- `400` — Validation error.
- `404` — Resource not found.
- `500` — Internal server error.

---

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