Skip to main content
GET
/
v2
/
tts
/
voices
List TTS voices
curl --request GET \
  --url https://api.tryhamsa.com/v2/tts/voices
{
  "success": true,
  "message": "Operation completed successfully",
  "messageKey": "OPERATION_SUCCESSFUL",
  "data": {
    "voices": [
      {
        "id": "633f19a6-089b-4950-bfab-55f5c750732e",
        "language": "ar",
        "name": "Aisha",
        "tags": [
          "female",
          "conversational"
        ],
        "voiceRecord": "https://cdn.tryhamsa.com/tts-voices/Aisha.wav",
        "createdAt": "2025-12-18T11:21:36.182Z",
        "isFavourite": false,
        "usedInJobs": true,
        "usedInVoiceAgents": true,
        "dialectId": "6ac0324d-bcb9-40f3-a57a-de6da7b721c8",
        "dialect": {
          "name": "Oman",
          "languageCode": "oma"
        },
        "image": "https://cdn.tryhamsa.com/tts-voices-images/aisha.jpg"
      }
    ],
    "totalPages": 5,
    "page": 1,
    "totalCount": 50
  }
}

Query Parameters

​
q
string

Search query string.

Example:

"test"

​
page
integer
required

Current page number.

Example:

1

​
perPage
integer
required

Number of voices per page.

Example:

10

​
source
enum<string>

Filter voices by source.

Available options:
jobs,
voice_agents
Example:

"voice_agents"

​
recentlyUsed
boolean

Filter by recently used flag.

Example:

true

​
all
boolean

Return all voices when true.

Example:

false

​
myVoices
boolean

Filter by voices owned by the user.

Example:

true

​
favourite
boolean

Filter favourite voices.

Example:

true

​
gender
enum<string>[]

Filter by one or more genders.

Available options:
male,
female
Example:
["male", "female"]
​
language
enum<string>[]

Filter by one or more languages.

Available options:
ar,
en
Example:
["ar", "en"]
​
style
enum<string>[]

Filter by one or more styles.

Available options:
narrator,
conversational
Example:
["narrator", "conversational"]
​
dialectId
string<uuid>[]

Filter by one or more dialect IDs (UUID).

Example:
[
  "ae6d58c6-c6bd-4ae0-ad74-b8b39c29928b",
  "2b9d0f7e-6c1b-4a41-9e41-3a7e6f5d9a11"
]
​
projectId
string
required

Project identifier.

Example:

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

Response

Voices retrieved successfully.

​
success
boolean
Example:

true

​
message
string
Example:

"Operation completed successfully"

​
messageKey
string
Example:

"OPERATION_SUCCESSFUL"

​
data
object