GET
/
api
/
v1
/
phone-numbers
/
list
curl "https://api.ravan.ai/api/v1/phone-numbers/list?is_active=true" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Phone numbers fetched successfully",
  "data": [
    {
      "id": "019d2a1b-4c5e-7f8a-9b0c-1d2e3f4a5b6c",
      "telephony_id": "019d2a1b-5d6f-7a8b-9c0d-2e3f4a5b6c7d",
      "subscription_id": "sub_1234567890",
      "inbound_trunk_id": "trk_inb_abc123",
      "outbound_trunk_id": "trk_out_def456",
      "number": "+13612738809",
      "friendly_name": "Sales Line",
      "per_minute_price_inbound": 0.0085,
      "per_minute_price_outbound": 0.0945,
      "price": 1.15,
      "region": "TX",
      "iso_country": "US",
      "is_active": true,
      "created_at": "2026-03-15T09:00:00Z",
      "updated_at": "2026-03-15T09:00:00Z"
    }
  ]
}

​
Authorizations

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

​
Query Parameters

​
region
string
Filter by region or state.
​
iso_country
string
Filter by ISO country code (e.g. US, GB).
​
is_active
boolean
Filter by active status — true for active numbers, false for inactive.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object[]
Array of purchased phone number records.
curl "https://api.ravan.ai/api/v1/phone-numbers/list?is_active=true" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "Phone numbers fetched successfully",
  "data": [
    {
      "id": "019d2a1b-4c5e-7f8a-9b0c-1d2e3f4a5b6c",
      "telephony_id": "019d2a1b-5d6f-7a8b-9c0d-2e3f4a5b6c7d",
      "subscription_id": "sub_1234567890",
      "inbound_trunk_id": "trk_inb_abc123",
      "outbound_trunk_id": "trk_out_def456",
      "number": "+13612738809",
      "friendly_name": "Sales Line",
      "per_minute_price_inbound": 0.0085,
      "per_minute_price_outbound": 0.0945,
      "price": 1.15,
      "region": "TX",
      "iso_country": "US",
      "is_active": true,
      "created_at": "2026-03-15T09:00:00Z",
      "updated_at": "2026-03-15T09:00:00Z"
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

Query Parameters

​
region
string

Region filter

​
iso_country
string

ISO country code filter

​
is_active
boolean

Filter by active status

Response

Successful response

​
success
boolean
​
message
string
​
data
object[]