Skip to main content
GET
/
v1
/
phone-numbers
curl https://api.vozagent.ai/v1/phone-numbers \
  -H "Authorization: Bearer <token>"

[
  {
    "id": "pn-a1b2c3d4-e5f6-a7b8-c9d0",
    "phone_number": "+15551234567",
    "label": "Main Line",
    "provider": "twilio",
    "status": "active",
    "assistant_id": "a1b2c3d4-e5f6-a7b8",
    "sms_enabled": true,
    "monthly_cost_cents": 200,
    "created_at": "2024-01-10T09:00:00Z"
  },
  {
    "id": "pn-b2c3d4e5-f6a7-b8c9-d0e1",
    "phone_number": "+15559876543",
    "label": "Sales Line",
    "provider": "vapi",
    "status": "active",
    "assistant_id": null,
    "sms_enabled": false,
    "monthly_cost_cents": 150,
    "created_at": "2024-01-12T14:30:00Z"
  }
]
Retrieve your API Key from your VozAgent Dashboard.

​
Query parameters

​
status
string
Filter by status: active, inactive, or pending.
​
provider
string
Filter by provider: twilio, vapi, telnyx, etc.

​
Response

Returns an array of phone number objects with their configuration.
​
id
string
Unique phone number identifier.
​
phone_number
string
Phone number in E.164 format.
​
label
string
Display label for the number.
​
provider
string
Telephony provider.
​
status
string
Current status.
​
assistant_id
string
Linked inbound assistant ID.
​
sms_enabled
boolean
Whether SMS is enabled.
curl https://api.vozagent.ai/v1/phone-numbers \
  -H "Authorization: Bearer <token>"

[
  {
    "id": "pn-a1b2c3d4-e5f6-a7b8-c9d0",
    "phone_number": "+15551234567",
    "label": "Main Line",
    "provider": "twilio",
    "status": "active",
    "assistant_id": "a1b2c3d4-e5f6-a7b8",
    "sms_enabled": true,
    "monthly_cost_cents": 200,
    "created_at": "2024-01-10T09:00:00Z"
  },
  {
    "id": "pn-b2c3d4e5-f6a7-b8c9-d0e1",
    "phone_number": "+15559876543",
    "label": "Sales Line",
    "provider": "vapi",
    "status": "active",
    "assistant_id": null,
    "sms_enabled": false,
    "monthly_cost_cents": 150,
    "created_at": "2024-01-12T14:30:00Z"
  }
]