---
title: "Get Phone Numbers"
method: GET
path: "/v1/api/numbers"
tags: ["Phone Numbers"]
deprecated: true
---

# Get Phone Numbers

`GET /v1/api/numbers`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v1/api/numbers`
- Auth: API key in header `Authorization`

> **Deprecated.**

**Deprecated.** Use `GET /v2/api/numbers` instead. This endpoint still responds, but it is no longer maintained and is not part of the current API reference.

Retrieve all Allo phone numbers associated with your account. Returns basic information about each number including country, name, and sharing status.

## Response `200`

Phone numbers retrieved successfully

- GetNumbersResponse: Standard response wrapper containing list of phone numbers
  - `data` PhoneNumberApiResponse[]
    - `number` string, nullable: Phone number in E.164 format
    - `name` string, nullable: Display name for the phone number
    - `country` string, nullable: Two-letter country code (ISO 3166-1 alpha-2)
    - `is_shared_number` boolean: Whether this number is shared across team members

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - API key lacks required scope
- `429`: Too Many Requests - Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v1/api/numbers/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)