List the phone voices
Returns the phone voice catalog — the 22 Dairo Live voices you can pass as voice on POST /v1/phone/calls or inboundVoice on a number — as a { object: "list", kind: "phone", data } array.
Returns the phone voice catalog — the 22 Dairo Live voices you can pass as voice on POST /v1/phone/calls or inboundVoice on a number — as a { object: "list", kind: "phone", data } array. Each row is { voiceId, name, description, language, gender, accent }: language is multilingual for the ten multilingual voices (marin — the default — cedar, alloy, ash, ballad, coral, echo, sage, shimmer, verse), otherwise en or pt, and accent names the regional accent. Filter with language (multilingual voices match every language), gender, and a free-text q; limit (1–100, default 50) and offset page the list. The same rows are served by GET /v1/telegram/voices?kind=phone.
Scope: phone:read. Send the API key as a bearer token; Scopes lists what each one reaches.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | no | Free-text search over id, name, description, accent and gender. |
language | string | no | Keep voices speaking this language (multilingual voices match every language). |
gender | string | no | Filter by gender. |
limit | integer | no | Maximum number of items in the page. (minimum 1, maximum 100, default 50) |
offset | integer | no | (minimum 0, default 0) |
Response
200 Success. Body: application/json, object.
| Field | Type | Required | Description |
|---|---|---|---|
object | "list" | no | |
kind | "phone" | no | |
count | integer | no | |
limit | integer | no | |
offset | integer | no | |
data | array of PhoneVoice | no |
Errors
Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.
| Status | Meaning |
|---|---|
400 | The request is malformed or a value is invalid (invalid_request, invalid_domain, idempotency_key_mismatch). |
401 | The API key is missing or invalid. |
403 | The key lacks the scope this endpoint needs (scope_missing) or may not do this (not_permitted). |
404 | No such resource in this account (resource_not_found). |
429 | Rate limit, plan limit, budget or spend cap reached (rate_limited, plan_limit_reached, budget_exceeded, spend_cap_reached). |
500 | An unexpected error; retry with backoff, then contact support (internal_error). |
Release a phone number back to the pool
Releases an owned number back to the carrier pool and stops its monthly billing.
List AI phone calls
Returns AI phone calls — outbound calls you placed and inbound calls your numbers answered (see direction) — most recent first, as a { object: "list", data } array.