cURL
curl -sS -X GET "https://dashboard.ondial.ai/api/v1/numbers/available" \
-H "Authorization: Bearer $ONDIAL_API_KEY"const res = await fetch("https://dashboard.ondial.ai/api/v1/numbers/available", {
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/numbers/available",
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/numbers/available");
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/numbers/available"))
.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/numbers/available");
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/numbers/available", 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))
}{
"numbers": [
{
"id": "66f0123456789abcdef01234",
"number": "+919876543210",
"country": "IN",
"countryName": "India",
"flagEmoji": "🇮🇳",
"cost": 7
}
],
"country": "IN",
"limit": 20,
"pricingNote": "Cost is per number in account credits (USD). Concurrent slots add to cost when concurrentCalls > 0."
}{
"error": "Invalid or inactive API key",
"reasonCode": "unauthorized"
}{
"error": "Pool inventory is not available for this account. Use Twilio purchase flow.",
"reasonCode": "pool_purchase_unavailable",
"numbers": []
}List available numbers
Browse purchasable India pool inventory with per-number cost.
GET
https://dashboard.ondial.ai
/
api
/
v1
/
numbers
/
available
cURL
curl -sS -X GET "https://dashboard.ondial.ai/api/v1/numbers/available" \
-H "Authorization: Bearer $ONDIAL_API_KEY"const res = await fetch("https://dashboard.ondial.ai/api/v1/numbers/available", {
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/numbers/available",
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/numbers/available");
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/numbers/available"))
.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/numbers/available");
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/numbers/available", 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))
}{
"numbers": [
{
"id": "66f0123456789abcdef01234",
"number": "+919876543210",
"country": "IN",
"countryName": "India",
"flagEmoji": "🇮🇳",
"cost": 7
}
],
"country": "IN",
"limit": 20,
"pricingNote": "Cost is per number in account credits (USD). Concurrent slots add to cost when concurrentCalls > 0."
}{
"error": "Invalid or inactive API key",
"reasonCode": "unauthorized"
}{
"error": "Pool inventory is not available for this account. Use Twilio purchase flow.",
"reasonCode": "pool_purchase_unavailable",
"numbers": []
}Query params:
Empty
| Param | Default | Notes |
|---|---|---|
country | Tenant billing country (usually IN) | ISO country filter |
limit | 150 (max 300) | Page size |
concurrentCalls | 0 | Included in each row’s cost when > 0 |
{
"numbers": [
{
"id": "66f...",
"number": "+91xxxxxxxxxx",
"country": "IN",
"countryName": "India",
"cost": 7
}
],
"country": "IN",
"limit": 20,
"pricingNote": "Cost is per number in account credits (USD). Concurrent slots add to cost when concurrentCalls > 0."
}
numbers: [] means pool inventory is exhausted for that country - purchase is not possible until inventory is restocked. Twilio/Telnyx search is not on this route (422 pool_purchase_unavailable when the tenant cannot buy pool).
Next: Purchase numbers.Authorizations
Paste only your API key (ond_live_… or ond_test_…). Do not type the word Bearer - the playground adds it.
Query Parameters
ISO country filter (defaults to tenant billing country)
Max rows to return
Required range:
x <= 300Included in each row cost when greater than 0

