List Purchased Numbers

List Purchased Numbers.

GET /api/v1/phone-numbers/list

List Purchased Numbers

cURL

curl --request GET \
  --url https://api.ravan.ai/api/v1/phone-numbers/list \
  --header 'X-Api-Key: <api-key>'

200

{
  "success": true,
  "message": "Request completed successfully",
  "data": [
    {
      "id": "id_123",
      "telephony_id": "telephony_123",
      "subscription_id": "subscription_123",
      "inbound_trunk_id": "inbound_trunk_123",
      "outbound_trunk_id": "outbound_trunk_123",
      "number": "[phone]",
      "friendly_name": "Support Bot",
      "per_minute_price_inbound": 1,
      "per_minute_price_outbound": 1,
      "price": 1,
      "region": "example",
      "iso_country": "US",
      "is_active": true,
      "created_at": "2026-03-14T12:00:00Z",
      "updated_at": "2026-03-14T12:00:00Z"
    }
  ]
}

Authorizations

X-Api-Key · string · required

Your Agni API key. Find it in your RavanAi.

---

Query Parameters

region · string

Region filter

iso_country · string

ISO country code filter

is_active · boolean

Filter by active status

---

Response

success · boolean

Whether the request succeeded.

message · string

Human-readable status message.

data · object[]

Returned data.

Show data[]

id · string

Record ID

telephony_id · string

Associated telephony ID

subscription_id · string

Associated subscription ID

inbound_trunk_id · string

Inbound SIP trunk ID

outbound_trunk_id · string

Outbound SIP trunk ID

number · string

Phone number in E.164 format

friendly_name · string

Human-readable label

per_minute_price_inbound · integer

Per-minute inbound price

per_minute_price_outbound · integer

Per-minute outbound price

price · integer

Monthly price

region · string

Region

iso_country · string

ISO country code

is_active · boolean

Whether the number is active

created_at · string

Creation timestamp

updated_at · string

Last update timestamp

200

{
  "success": true,
  "message": "Request completed successfully",
  "data": [
    {
      "id": "id_123",
      "telephony_id": "telephony_123",
      "subscription_id": "subscription_123",
      "inbound_trunk_id": "inbound_trunk_123",
      "outbound_trunk_id": "outbound_trunk_123",
      "number": "[phone]",
      "friendly_name": "Support Bot",
      "per_minute_price_inbound": 1,
      "per_minute_price_outbound": 1,
      "price": 1,
      "region": "example",
      "iso_country": "US",
      "is_active": true,
      "created_at": "2026-03-14T12:00:00Z",
      "updated_at": "2026-03-14T12: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

200 - application/json

Successful response

success · boolean

message · string

data · object[]

Show child attributes