---
title: "Get numbers belonging to the account"
method: GET
path: "/phone-details/numbers"
tags: ["Phone Details"]
---

# Get numbers belonging to the account

`GET /phone-details/numbers`

## Request

- Base URL: `https://api.talkdeskapp.com`
- URL: `https://api.talkdeskapp.com/phone-details/numbers`
- Auth: OAuth 2
  - Authorization code: `https://{account_name}.talkdeskid.com/oauth/authorize`
  - Token URL: `https://{account_name}.talkdeskid.com/oauth/token` scopes: `phone-details:read`

Get numbers belonging to the account

## Query parameters

- `page` integer, required
- `per_page` integer, required
- `sip` boolean
- `vcid` boolean
- `search` string
- `search_fields` string
- `order_by` string

## Response `200`

List of numbers for the account

- object
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `count` integer, required
  - `_embedded` object, required
    - `phone_numbers` object[], required
      - `id` string, required: the ID for the phone number
      - `phone_number` string, required: the phone number in E.164 format
      - `friendly_name` string, required: the friendly name for the phone number
      - `dedicated_line` boolean, required: if the phone number is a dedicated line or not
      - `dedicated_line_agent_id` string: the agent ID associated to the dedicated line
      - `sip` boolean, required: if the phone number is SIP
      - `vcid` boolean, required: if the phone number is a VCID (verified caller ID)
      - `capabilities` unknown[], required: The phone number's supported capabilities (e.g. SMS, Voice, MMS, etc.)
        - unknown
  - `_links` object, required
    - `self` object, required
      - `href` string, required
    - `first` object
      - `href` string, required
    - `next` object
      - `href` string, required
    - `previous` object
      - `href` string, required
    - `last` object
      - `href` string, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden access
- `405`: Method not allowed

## Changes

- **2026-11-03** `f69c52fd7456`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/talkdesk/apis/talkdesk/changes/phone-details/numbers/get.md)

---

[API](https://skmtc.dev/talkdesk/apis/talkdesk.md) - [All operations](https://skmtc.dev/talkdesk/apis/talkdesk/llms.txt) - [OpenAPI document](https://skmtc.dev/talkdesk/apis/talkdesk/revisions/f69c52fd7456?raw)