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[]