---
title: "List TTS voices"
method: GET
path: "/v2/tts/voices"
---

# List TTS voices

`GET /v2/tts/voices`

Retrieve available TTS voices with optional filtering, pagination, and source flags.

## Query parameters

- `q` string
- `page` integer, required
- `perPage` integer, required
- `source` 'jobs' | 'voice_agents', required
- `recentlyUsed` boolean
- `all` boolean
- `myVoices` boolean
- `favourite` boolean
- `gender` string[]
- `language` string[]
- `style` string[]
- `dialectId` string[]
- `projectId` string, required

## Response `200`

Voices retrieved successfully.

- ListTtsVoicesResponse
  - `success` boolean
  - `message` string
  - `messageKey` string
  - `data` object
    - `voices` TtsVoice[]
      - `id` string, uuid, required
      - `language` 'en' | 'ar', required
      - `name` string, required
      - `tags` string[], required
      - `voiceRecord` string, uri, required — Signed URL for the voice audio sample
      - `dialectId` string, uuid, nullable
      - `dialect` object, nullable
        - `name` string
        - `languageCode` string
      - `image` string, uri, nullable — Avatar image for the voice
      - `createdAt` string, date-time, required
      - `isFavourite` boolean, required
      - `usedInJobs` boolean, required — Indicates whether this voice has been used in TTS jobs
      - `usedInVoiceAgents` boolean, required — Indicates whether this voice is assigned to any voice agents
    - `totalPages` integer
    - `page` integer
    - `totalCount` integer

## Other responses

- `400` — Validation error.
- `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)