---
title: "Gets the details of the given purchased phone number."
method: GET
path: "/phoneNumbers/{phoneNumber}"
tags: ["Manage purchased phone numbers"]
---

# Gets the details of the given purchased phone number.

`GET /phoneNumbers/{phoneNumber}`

## Path parameters

- `phoneNumber` string, required

## Query parameters

- `api-version` string, required

## Response `200`

Success

- PurchasedPhoneNumber — Represents a purchased phone number.
  - `id` string, required — The id of the phone number, e.g. 11234567890.
  - `phoneNumber` string, required — String of the E.164 format of the phone number, e.g. +11234567890.
  - `countryCode` string, required — The ISO 3166-2 code of the phone number's country, e.g. US.
  - `phoneNumberType` 'geographic' | 'tollFree' | 'mobile', required — The phone number's type, e.g. geographic, tollFree, mobile.
  - `capabilities` PhoneNumberCapabilities, required — Capabilities of a phone number.
    - `calling` 'none' | 'inbound' | 'outbound' | 'inbound+outbound', required — Capability value for calling.
    - `sms` 'none' | 'inbound' | 'outbound' | 'inbound+outbound', required — Capability value for SMS.
  - `assignmentType` 'person' | 'application', required — The assignment type of the phone number. A phone number can be assigned to a person, or to an application.
  - `purchaseDate` string, date-time, required — The date and time that the phone number was purchased.
  - `cost` PhoneNumberCost, required — The incurred cost for a single phone number.
    - `amount` number, double, required — The cost amount.
    - `currencyCode` string, required — The ISO 4217 currency code for the cost amount, e.g. USD.
    - `billingFrequency` 'monthly', required — The frequency with which the cost gets billed.

## Other responses

- `default` — Failure

---

[API](https://skmtc.dev/azure/apis/communication-phonenumbers.md) · [All operations](https://skmtc.dev/azure/apis/communication-phonenumbers/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-phonenumbers/revisions/6e81b3741aa7/schema)