Skip to main content
GET
/
v1
/
phone-numbers
List phone numbers
curl --request GET \
  --url https://api.nixflex.com/v1/phone-numbers

Documentation Index

Fetch the complete documentation index at: https://docs.nixflex.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns every phone number belonging to your account.

​
Request

# All numbers
curl https://api.nixflex.com/v1/phone-numbers \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"

# Filter to one agent
curl "https://api.nixflex.com/v1/phone-numbers?agent_id=agent_125207e452f8714a" \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"

​
Query parameters

ParameterTypeNotes
agent_idstringFilter numbers attached to one agent
limitintDefault 25, max 100
offsetintPagination offset

​
Response

200 OK: 
{
  "phone_numbers": [
    {
      "phone_number": "+447446466847",
      "agent_id": "agent_125207e452f8714a",
      "twilio_number_sid": "PN451e0ddf654327e36baab58dfbcd30d6",
      "inbound_enabled": true,
      "outbound_enabled": true,
      "created_at": "2026-05-03T01:59:31.548911+00:00"
    }
  ],
  "count": 1
}
Sorted by created_at descending. Returns an empty array (not 404) if no numbers exist.