List phone numbers

GET /api/v1/organizations/telephony-configs/{config_id}/phone-numbers

Lists every phone number added to this configuration, including the name of any attached inbound agent.

Added vs available

This returns numbers you've registered in zoxaAI. To see the DIDs your provider account exposes that you haven't added yet, use available-numbers.

Response

{
  "phone_numbers": [
    {
      "id": 88,
      "telephony_configuration_id": 7,
      "address": "+14155550100",
      "address_normalized": "+14155550100",
      "address_type": "pstn",
      "country_code": "US",
      "label": "Main line",
      "inbound_agent_id": 42,
      "inbound_agent_uuid": "550e8400-e29b-41d4-a716-446655440000",
      "inbound_agent_name": "Support bot",
      "is_active": true,
      "is_default_caller_id": true,
      "extra_metadata": {},
      "created_at": "2026-06-02T10:00:00Z",
      "updated_at": "2026-06-18T14:00:00Z"
    }
  ]
}

Field	Type	Description
`id`	int	The `phone_number_id`.
`address`	string	The number as you entered it (verbatim).
`address_normalized`	string	Canonical E.164 (server-computed).
`inbound_agent_uuid` / `inbound_agent_name`	string / string	Attached inbound agent, if any. `inbound_agent_id` is its internal numeric id, returned for reference.
`is_default_caller_id`	bool	Used as the outbound caller ID when none is specified.

Examples

curl https://dashboard.zoxa.ai/api/v1/organizations/telephony-configs/7/phone-numbers \
  -H "X-API-Key: zsk_..."

import httpx
r = httpx.get(
    "https://dashboard.zoxa.ai/api/v1/organizations/telephony-configs/7/phone-numbers",
    headers={"X-API-Key": "zsk_..."},
)
numbers = r.json()["phone_numbers"]

Errors

Status	`detail`	When
`404`	`"Telephony configuration not found"`	`config_id` not in your org.

Response

Examples

Errors

Related

On this page