---
title: "Retrieve a single phone number"
method: GET
path: "/phone_number/{id}/"
tags: ["phone_numbers"]
---

# Retrieve a single phone number

`GET /phone_number/{id}/`

## Path parameters

- `id` string, required

## Query parameters

- `_fields` string

## Response `200`

Successful response

- PhoneNumber
  - `address_id` string, nullable, required
  - `bundle_id` string, nullable, required
  - `carrier` 'twilio' | 'plivo', required
  - `carrier_type` 'local' | 'national' | 'mobile' | 'tollfree' | 'shortcode', required
  - `country` string, nullable, required
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `forward_to` string, nullable
  - `forward_to_enabled` boolean
  - `forward_to_formatted` string, nullable
  - `id` string, required
  - `inbound_ring_duration` integer, nullable — Number of seconds we ring this number on inbound calls before moving on (e.g. to voicemail). `null` means the default of 30 seconds is used.
  - `is_group_number` boolean, required — Deprecated. The distinction between personal and group numbers is being removed, and `is_group_number` will be removed in a future update.
  - `is_premium` boolean, required
  - `is_verified` boolean, required
  - `label` string, required
  - `last_billed_price` number, nullable, required
  - `mms_enabled` boolean, required
  - `next_billing_on` string, date-time, nullable, required
  - `number` string, required
  - `number_formatted` string, required
  - `organization_id` string, required
  - `participants` string[]
  - `phone_numbers` string[]
  - `phone_numbers_formatted` string[]
  - `press_1_to_accept` boolean
  - `sms_enabled` boolean, required
  - `supports_mms_to_countries` string[], required
  - `supports_sms_to_countries` string[], required
  - `type` 'internal' | 'external' | 'virtual', required
  - `user_id` string, nullable, required — Deprecated. Set to the sole member's user ID for single-member numbers, otherwise `null`. `user_id` will be removed in a future update.
  - `voicemail_greeting_url` string, nullable
  - `was_ported` boolean

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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