Skip to main content
GET
/
v1
/
list-phone-numbers
curl https://api.voicy.co/v1/list-phone-numbers \
  -H "Authorization: Bearer voicy_sk_live_xxx"

[
  {
    "phone_number_id": "550e8400-e29b-41d4-a716-446655440000",
    "phone_number": "+15551234567",
    "phone_number_pretty": "(555) 123-4567",
    "display_name": "Main Support Line",
    "account_id": "550e8400-e29b-41d4-a716-446655440099",
    "account_name": "Acme Corp",
    "agent_id": "550e8400-e29b-41d4-a716-446655440001",
    "agent_name": "Customer Support Agent",
    "agent_version": 3,
    "status": "active",
    "created_at": "2026-01-15T10:30:00Z"
  },
  {
    "phone_number_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_number": "+972501234567",
    "phone_number_pretty": "050-123-4567",
    "display_name": null,
    "account_id": "550e8400-e29b-41d4-a716-446655440099",
    "account_name": "Acme Corp",
    "agent_id": null,
    "agent_name": null,
    "agent_version": null,
    "status": "unassigned",
    "created_at": "2026-01-14T08:00:00Z"
  }
]
Retrieve a list of all phone numbers associated with your account.

​
Response

Returns an array of Phone Number objects. 
curl https://api.voicy.co/v1/list-phone-numbers \
  -H "Authorization: Bearer voicy_sk_live_xxx"

[
  {
    "phone_number_id": "550e8400-e29b-41d4-a716-446655440000",
    "phone_number": "+15551234567",
    "phone_number_pretty": "(555) 123-4567",
    "display_name": "Main Support Line",
    "account_id": "550e8400-e29b-41d4-a716-446655440099",
    "account_name": "Acme Corp",
    "agent_id": "550e8400-e29b-41d4-a716-446655440001",
    "agent_name": "Customer Support Agent",
    "agent_version": 3,
    "status": "active",
    "created_at": "2026-01-15T10:30:00Z"
  },
  {
    "phone_number_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_number": "+972501234567",
    "phone_number_pretty": "050-123-4567",
    "display_name": null,
    "account_id": "550e8400-e29b-41d4-a716-446655440099",
    "account_name": "Acme Corp",
    "agent_id": null,
    "agent_name": null,
    "agent_version": null,
    "status": "unassigned",
    "created_at": "2026-01-14T08:00:00Z"
  }
]