---
title: "GET /phone/numbers"
method: GET
path: "/phone/numbers"
---

# GET /phone/numbers

`GET /phone/numbers`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/phone/numbers`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `agentId` union, required: Agent whose phone numbers to list
  - string
  - string

## Response `200`

OK

- object: List of phone numbers assigned to an agent
  - `items` object[], required: Array of phone identity records for the agent
    - `id` string, required: Unique identifier of the phone identity
    - `phoneNumber` string, required: Phone number in E.164 format
    - `providerId` string, nullable, required: Opaque carrier-side identifier for this phone number
    - `capabilities` object, required: Communication capabilities supported by this phone number
      - `sms` boolean: Whether the number supports SMS messaging
      - `mms` boolean: Whether the number supports MMS messaging
      - `voice` boolean: Whether the number supports voice calls
    - `tenDlcStatus` 'PENDING' | 'REGISTERED' | 'REJECTED' | 'NOT_REQUIRED' | 'UNREGISTERED', required: 10DLC campaign registration status
    - `isPrimary` boolean, required: Whether this is the agent's primary phone identity
    - `voiceId` string, nullable, required: The voice this number answers with, from the voice catalog. Null means it uses the agent's voice, and then the system default. Set it per number so one agent's support line and sales line can sound different.
    - `createdAt` string, date-time, required: Timestamp when the phone identity was created

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)