List Available Numbers
curl --request GET \
--url https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/ \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Request completed successfully",
"data": [
{
"iso_country": "US",
"phone_number": "+14155550100",
"price": 1,
"per_minute_price_outbound": 1,
"per_minute_price_inbound": 1
}
]
}
Phone Number & Telephony API
List Available Numbers
List Available Numbers.
GET
/
api
/
v1
/
phone-numbers
/
available-numbers
/
{iso_country}
/
List Available Numbers
curl --request GET \
--url https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/ \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ravan.ai/api/v1/phone-numbers/available-numbers/{iso_country}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Request completed successfully",
"data": [
{
"iso_country": "US",
"phone_number": "+14155550100",
"price": 1,
"per_minute_price_outbound": 1,
"per_minute_price_inbound": 1
}
]
}
Authorizations
string
required
Your Agni API key used to authenticate the request. Pass it in the
X-Api-Key header. Find or rotate it from your Ravan AI account settings.Path Parameters
string
required
The ISO 3166-1 alpha-2 country code. Example:
US.Query Parameters
integer
The number of records to return per page.
string
Filters available numbers by region, state, province, or locality when supported.
Response
boolean
Whether the request succeeded.
string
Human-readable status message.
object[]
{
"success": true,
"message": "Request completed successfully",
"data": [
{
"iso_country": "US",
"phone_number": "+14155550100",
"price": 1,
"per_minute_price_outbound": 1,
"per_minute_price_inbound": 1
}
]
}
Authorizations
Path Parameters
ISO country code (e.g. US, GB)

