---
title: "Gets the list of all purchased phone numbers."
method: GET
path: "/phoneNumbers"
tags: ["Manage purchased phone numbers"]
---

# Gets the list of all purchased phone numbers.

`GET /phoneNumbers`

## Query parameters

- `skip` integer
- `top` integer
- `api-version` string, required

## Response `200`

Success

- PurchasedPhoneNumbers — The list of purchased phone numbers.
  - `phoneNumbers` PurchasedPhoneNumber[], required — Represents a list of phone numbers.
    - `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.
  - `nextLink` string — Represents the URL link to the next page of phone number results.

## 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)