GET
/
api
/
v1
/
phone-numbers
/
available-numbers
/
{iso_country}
curl "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/US/?page_size=3" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Available numbers fetched successfully",
  "data": [
    {
      "isoCountry": "US",
      "phoneNumber": "+13612738809",
      "price": 1.15,
      "perMinutePriceOutbound": 0.0945,
      "perMinutePriceInbound": 0.0085,
      "telephonyType": ""
    },
    {
      "isoCountry": "US",
      "phoneNumber": "+13613211404",
      "price": 1.15,
      "perMinutePriceOutbound": 0.0945,
      "perMinutePriceInbound": 0.0085,
      "telephonyType": ""
    },
    {
      "isoCountry": "US",
      "phoneNumber": "+13614189049",
      "price": 1.15,
      "perMinutePriceOutbound": 0.0945,
      "perMinutePriceInbound": 0.0085,
      "telephonyType": ""
    }
  ]
}

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key. Find it in your support@ravan.ai under Settings → API Keys.

​
Path Parameters

​
iso_country
string
required
Two-letter ISO 3166-1 alpha-2 country code (e.g. US, GB, IN, DE).

​
Query Parameters

​
page_size
integer
Number of available numbers to return. Useful for limiting results when browsing.
​
region
string
Filter by region or state within the country (e.g. CA for California, TX for Texas).

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object[]
Array of available phone numbers.
curl "https://api.ravan.ai/api/v1/phone-numbers/available-numbers/US/?page_size=3" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Available numbers fetched successfully",
  "data": [
    {
      "isoCountry": "US",
      "phoneNumber": "+13612738809",
      "price": 1.15,
      "perMinutePriceOutbound": 0.0945,
      "perMinutePriceInbound": 0.0085,
      "telephonyType": ""
    },
    {
      "isoCountry": "US",
      "phoneNumber": "+13613211404",
      "price": 1.15,
      "perMinutePriceOutbound": 0.0945,
      "perMinutePriceInbound": 0.0085,
      "telephonyType": ""
    },
    {
      "isoCountry": "US",
      "phoneNumber": "+13614189049",
      "price": 1.15,
      "perMinutePriceOutbound": 0.0945,
      "perMinutePriceInbound": 0.0085,
      "telephonyType": ""
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
iso_country
string
required

ISO country code (e.g. US, GB)

Query Parameters

​
page_size
integer<int32>

Number of results per page

​
region
string

Region filter

Response

Successful response

​
success
boolean
​
message
string
​
data
object[]