---
title: "List phone numbers"
method: GET
path: "/v2/api/numbers"
tags: ["Phone Numbers"]
---

# List phone numbers

`GET /v2/api/numbers`

Returns all phone numbers and sender IDs on your team.

## Response `200`

List of phone numbers

- object
  - `data` PhoneNumber[]
    - `number` string, nullable — Phone number in E.164 format (null for sender IDs)
    - `name` string, nullable — Display label
    - `country` string, nullable — ISO country code
    - `type` 'NUMBER' | 'SENDER_ID' — Whether this is a phone number or a sender ID
    - `capabilities` string[] — Supported capabilities for this number.
    - `users` UserRef[] — Team members with access to this number
      - `id` string
      - `name` string
      - `email` string

## Other responses

- `401` — Invalid or missing API key
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) · [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withallo/allo-api/revisions/9aab4db82933/schema)