---
title: "Get a specific phone number's details"
method: GET
path: "/numbers/{number}"
tags: ["numbers"]
---

# Get a specific phone number's details

`GET /numbers/{number}`

Retrieves detailed information about a specific phone number, including its assignment (user, IVR, conference), country, capabilities, and configuration. The number is identified by its phone number in E.164 format without the `+` prefix (e.g., `33140000000`).

**Permission:** `Numbers Read` required.

**Monitoring impact:**
- **OFF:** Returns the number only if it is **assigned to you**. Requesting a number belonging to another user returns `404`.
- **ON:** Returns details for **any number** in the team.

## Path parameters

- `number` integer, required

## Response `200`

Successful operation — returns the number details.

- Number
  - `number` integer — Phone number in E.164 format without the `+` prefix (e.g., `33612345678`).
  - `label` string — The label of the number
  - `type` string — The type of the number
  - `user_id` integer — The user identifier
  - `ivr_id` integer — The unique identifier of the IVR. Use `GET /ivrs` to discover available IVR IDs.
  - `conference_id` integer — The conference identifier
  - `is_sms` boolean
  - `is_sms_write` boolean
  - `is_callable` boolean
  - `format` FormatNumber
    - `raw` integer
    - `country_code` string
    - `country` string
    - `e164` string
    - `international` string
    - `international_alt` string
    - `national` string
    - `national_alt` string
    - `rfc3966` string
    - `is_short_code` boolean

## Other responses

- `400` — Invalid phone number format.
- `401` — Unauthorized — invalid or missing API token, or missing `Numbers Read` permission.
- `404` — Number not found, or not accessible with current monitoring level.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)