Voices you can use

GET

/api/v1/voices

App integration: Populate a picker using returned IDs, supported models and locale rather than hard-coded display names. This is one of only two endpoints permitted for the isolated app test identity. Voice availability can change.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://handwrites.io/oauth/authorize

Token URL: https://handwrites.io/api/oauth/token

Refresh URL: https://handwrites.io/api/oauth/token

Scopes:

voices:read-List voices and see your character allowance

Query Params

Responses

🟢200

application/json

The voices.

Headers

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

🔴500ServerError

🔴502BadGateway

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/voices?locale=&model=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "voices": [
        {
            "id": "string",
            "display_name": "string",
            "gender": "string",
            "locale": "string",
            "type": "string",
            "models": [
                {
                    "name": "string",
                    "property1": "string",
                    "property2": "string"
                }
            ],
            "preview_audio": "string",
            "staff_pick_rank": 0,
            "tags": [
                "string"
            ]
        }
    ]
}

Modified at 2026-10-26 12:58:15

Speech with word timings (read-along)

Characters left, limit, plan and reset time