cURL
curl -sS -X GET "https://dashboard.ondial.ai/api/v1/voices" \
-H "Authorization: Bearer $ONDIAL_API_KEY"const res = await fetch("https://dashboard.ondial.ai/api/v1/voices", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.ONDIAL_API_KEY}`,
},
});
const data = await res.json();
console.log(res.status, data);import os
import requests
res = requests.request(
"GET",
"https://dashboard.ondial.ai/api/v1/voices",
headers={
"Authorization": f"Bearer {os.environ['ONDIAL_API_KEY']}",
},
timeout=30,
)
print(res.status_code, res.json())<?php
$ch = curl_init("https://dashboard.ondial.ai/api/v1/voices");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("ONDIAL_API_KEY"),
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status . " " . $response;import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://dashboard.ondial.ai/api/v1/voices"))
.header("Authorization", "Bearer " + System.getenv("ONDIAL_API_KEY"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}using System;
using System.Net.Http;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://dashboard.ondial.ai/api/v1/voices");
request.Headers.Add("Authorization", "Bearer " + Environment.GetEnvironmentVariable("ONDIAL_API_KEY"));
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode + " " + await response.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://dashboard.ondial.ai/api/v1/voices", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("ONDIAL_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(out))
}{
"market": "IN",
"tier": "<string>",
"allowedTiers": {
"standard": true,
"premium": true
},
"languages": [
{
"code": "hi-IN",
"name": "Hindi"
}
],
"voices": [
{
"id": "Priya::hi-IN",
"name": "<string>",
"displayName": "<string>",
"gender": "<string>",
"tier": "<string>",
"languages": [
"<string>"
],
"languageCode": "<string>",
"accent": "<string>",
"audioFile": "<string>",
"isRecommended": true,
"selectedVoice": {
"name": "Priya",
"displayName": "Ishita",
"gender": "Female",
"language": {
"code": "hi-IN",
"name": "Hindi"
},
"tier": "standard",
"accent": "Standard",
"playbackSpeed": 1,
"audioFile": "<string>"
}
}
],
"count": 123
}{
"error": "Invalid or inactive API key",
"reasonCode": "unauthorized"
}{
"leadId": 177,
"error": "<string>",
"reasonCode": "<string>",
"missing": [
"<string>"
]
}List voices
TTS voice catalog for inbound agent create/update.
GET
https://dashboard.ondial.ai
/
api
/
v1
/
voices
cURL
curl -sS -X GET "https://dashboard.ondial.ai/api/v1/voices" \
-H "Authorization: Bearer $ONDIAL_API_KEY"const res = await fetch("https://dashboard.ondial.ai/api/v1/voices", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.ONDIAL_API_KEY}`,
},
});
const data = await res.json();
console.log(res.status, data);import os
import requests
res = requests.request(
"GET",
"https://dashboard.ondial.ai/api/v1/voices",
headers={
"Authorization": f"Bearer {os.environ['ONDIAL_API_KEY']}",
},
timeout=30,
)
print(res.status_code, res.json())<?php
$ch = curl_init("https://dashboard.ondial.ai/api/v1/voices");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("ONDIAL_API_KEY"),
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status . " " . $response;import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://dashboard.ondial.ai/api/v1/voices"))
.header("Authorization", "Bearer " + System.getenv("ONDIAL_API_KEY"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}using System;
using System.Net.Http;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://dashboard.ondial.ai/api/v1/voices");
request.Headers.Add("Authorization", "Bearer " + Environment.GetEnvironmentVariable("ONDIAL_API_KEY"));
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode + " " + await response.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://dashboard.ondial.ai/api/v1/voices", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("ONDIAL_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(out))
}{
"market": "IN",
"tier": "<string>",
"allowedTiers": {
"standard": true,
"premium": true
},
"languages": [
{
"code": "hi-IN",
"name": "Hindi"
}
],
"voices": [
{
"id": "Priya::hi-IN",
"name": "<string>",
"displayName": "<string>",
"gender": "<string>",
"tier": "<string>",
"languages": [
"<string>"
],
"languageCode": "<string>",
"accent": "<string>",
"audioFile": "<string>",
"isRecommended": true,
"selectedVoice": {
"name": "Priya",
"displayName": "Ishita",
"gender": "Female",
"language": {
"code": "hi-IN",
"name": "Hindi"
},
"tier": "standard",
"accent": "Standard",
"playbackSpeed": 1,
"audioFile": "<string>"
}
}
],
"count": 123
}{
"error": "Invalid or inactive API key",
"reasonCode": "unauthorized"
}{
"leadId": 177,
"error": "<string>",
"reasonCode": "<string>",
"missing": [
"<string>"
]
}Usage
- Call
GET /api/v1/voiceswith filters for your agent phone market and language. - Pick a row from
voices[]. - Copy
voices[i].selectedVoiceexactly intoPOSTorPATCH/api/v1/inbound-agents. - Set
primaryLanguagetoselectedVoice.language.code(optional if you passselectedVoice- Ondial syncs it).
Query parameters
| Parameter | Description |
|---|---|
market | IN (default) or INTL |
phoneNumber | Optional E.164. When set without market, picks catalog from phone country |
tier | standard, premium, elite, or all (default premium). Must be enabled for tenant (allowedTiers in response) |
language | BCP-47 filter: full code (hi-IN) or prefix (hi) |
gender | Optional: male or female |
Response
Each voice row includes:selectedVoice- ready-to-POST object (name,displayName,gender,language,tier,accent,playbackSpeed)languageCode- locale used inselectedVoice.language.codeallowedTiers- which tiers this tenant may use
Example
GET /api/v1/voices?market=IN&tier=premium&language=hi-IN
Authorization: Bearer ond_live_...
{
"market": "IN",
"tier": "premium",
"allowedTiers": { "standard": true, "premium": true },
"count": 42,
"voices": [
{
"id": "Priya::hi-IN",
"name": "Priya",
"displayName": "Ishita",
"gender": "Female",
"tier": "premium",
"languageCode": "hi-IN",
"selectedVoice": {
"name": "Priya",
"displayName": "Ishita",
"gender": "Female",
"language": { "code": "hi-IN", "name": "Hindi" },
"tier": "premium",
"accent": "Standard",
"playbackSpeed": 0.9
}
}
]
}
Errors
| Status | reasonCode | When |
|---|---|---|
| 422 | tier_not_allowed | Requested tier not enabled for tenant |
| 422 | invalid_selected_voice | On create/PATCH when selectedVoice is not in catalog for agent phone |
Alternatives
- Omit
selectedVoiceon create - Ondial assigns a default voice for the agent phone +primaryLanguage. - Set
copyVoiceFromAgentIdinstead ofselectedVoiceto clone from another inbound agent.
Authorizations
Paste only your API key (ond_live_… or ond_test_…). Do not type the word Bearer - the playground adds it.
Query Parameters
Available options:
IN, INTL Optional E.164 agent phone. When set without market, auto-selects IN vs INTL catalog.
Example:
"+919876543210"
Available options:
standard, premium, elite, all BCP-47 filter (full code or language prefix), e.g. hi-IN or hi
Example:
"hi-IN"
Optional picker filter
Available options:
male, female Response
Voice catalog
Available options:
IN, INTL Hide child attributes
Hide child attributes
Example:
"Priya::hi-IN"
Locale used in selectedVoice.language.code for this row.
Hide child attributes
Hide child attributes
Catalog voice id (case-insensitive match).
Example:
"Priya"
Example:
"Ishita"
Example:
"Female"
Normalized tier (catalog basic maps to standard).
Available options:
standard, premium, elite Example:
"Standard"
Required range:
0.5 <= x <= 2Example:
1

