Skip to main content
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>'
{
  "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

​
X-Api-Key
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

​
iso_country
string
required
The ISO 3166-1 alpha-2 country code. Example: US.

​
Query Parameters

​
page_size
integer
The number of records to return per page.
​
region
string
Filters available numbers by region, state, province, or locality when supported.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object[]
Returned data.
{
  "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

​
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

200 - application/json

Successful response

​
success
boolean
​
message
string
​
data
object[]