# Retrieve a phone number (/docs/api/routing/phone-numbers/getPhoneNumber)

> For the complete documentation index, see [llms.txt](https://docs.tandemcx.ai/llms.txt). Any page on this site can be fetched as Markdown by appending `.md` to its URL.

`GET /v1/routing/phone-numbers/{phoneNumberId}`

Retrieve a phone number

Read one phone number by its ID.

## Request

**Base URL:** `https://api.tandemcx.ai`

**Authentication:** `Authorization: Bearer <token>` — A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.

### Path parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `phoneNumberId` | string | Yes | The phone number's unique ID. |

## Responses

### 200 — The phone number.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | The phone number's unique ID. |
| `label` | string | Yes | Friendly name for the number, up to 200 characters. |
| `phoneNumber` | string | Yes | The number in E.164 format. |
| `workflowId` | string | No | Legacy mirror of a workflow route target, maintained for older integrations. Present only while the number routes to a workflow. Prefer target. |
| `target` | one of: object \| object | No | Where an inbound call to this number is routed. |
| `variables` | object | No | Values made available to the workflow or agent run this number starts. At most 50 variables, with names up to 128 characters and values up to 2,000 characters. All names and values together may not exceed 64 KB (UTF-8 bytes). |
| `recordCalls` | enum: `inherit` \| `always` \| `never` | No | Whether calls on this number are recorded. inherit follows the organization's default; always and never override it. Absent on a number that has never set one, which behaves as inherit. |
| `smsCapability` | enum: `enabled` \| `disabled` \| `pending` | Yes | Whether the number can use a messaging channel. A newly purchased number starts as pending until the carrier confirms it. |
| `mmsCapability` | enum: `enabled` \| `disabled` \| `pending` | Yes | Whether the number can use a messaging channel. A newly purchased number starts as pending until the carrier confirms it. |
| `createdAt` | string (date-time) | Yes | — |
| `updatedAt` | string (date-time) | Yes | — |

### 401 — Missing, malformed, or expired bearer token.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | No | — |
| `error.code` | string | No | — |
| `error.message` | string | No | — |

### 404 — The resource does not exist.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | No | — |
| `error.code` | string | No | — |
| `error.message` | string | No | — |