Skip to main content
GET
/
api
/
phone-numbers
List Phone Numbers
curl --request GET \
  --url https://api.example.com/api/phone-numbers
{
  "phone_numbers": [
    {
      "phone_number_id": "pn_123",
      "phone_number": "+15550101",
      "provider": "twilio",
      "status": "assigned",
      "assigned_agent_id": "agent_456"
    },
    {
      "phone_number_id": "pn_789",
      "phone_number": "+15550102",
      "provider": "livekit_sip",
      "status": "free",
      "assigned_agent_id": null
    }
  ],
  "count": 2,
  "organization": "My Org",
  "user_role": "admin"
}
List all phone numbers configured for your organization.
​
status
string
Filter by status (e.g., free, assigned).

​
Response

​
phone_numbers
array
List of phone number objects.
​
count
number
Total count of phone numbers.
{
  "phone_numbers": [
    {
      "phone_number_id": "pn_123",
      "phone_number": "+15550101",
      "provider": "twilio",
      "status": "assigned",
      "assigned_agent_id": "agent_456"
    },
    {
      "phone_number_id": "pn_789",
      "phone_number": "+15550102",
      "provider": "livekit_sip",
      "status": "free",
      "assigned_agent_id": null
    }
  ],
  "count": 2,
  "organization": "My Org",
  "user_role": "admin"
}