---
title: "Get Number"
method: GET
path: "/v1/numbers/{number_id}"
tags: ["numbers"]
---

# Get Number

`GET /v1/numbers/{number_id}`

Get a single phone number owned by this account.

Returns the number regardless of status (including released) so detail
pages still load for numbers that are no longer active.

## Path parameters

- `number_id` string, required

## Response `200`

Successful Response

- PhoneNumberResponse
  - `id` string, required
  - `phoneNumber` string, required
  - `country` string, required
  - `status` string, required
  - `type` string
  - `agentId` string, nullable
  - `outboundSms` 'enabled' | 'activating' | 'registration_required'
  - `inboundCallsEnabled` boolean
  - `whatsappEnabled` boolean
  - `createdAt` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-28** `6efa707e8ebd` — 1 info
  - added the optional property `whatsappEnabled` to the response with the `200` status
- **2026-08-27** `c179300fcb4a` — 1 info
  - added the optional property `inboundCallsEnabled` to the response with the `200` status
- **2026-08-08** `5724ccaa33d8` — 1 info
  - added the optional property `outboundSms` to the response with the `200` status

[Change history](https://skmtc.dev/agentphone/apis/agentphone-api/changes/v1/numbers/:number_id/get.md)

---

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