---
title: "List Account Phone Numbers"
method: GET
path: "/restapi/v2/accounts/{accountId}/phone-numbers"
tags: ["Phone Numbers"]
---

# List Account Phone Numbers

`GET /restapi/v2/accounts/{accountId}/phone-numbers`

Returns the list of phone numbers assigned to RingCentral customer
account. Both company-level and extension-level numbers are returned.
Conferencing numbers, hot desk and ELIN numbers are not returned.

## Path parameters

- `accountId` string, required

## Query parameters

- `page` integer
- `perPage` integer
- `type` PhoneNumberType[]
- `usageType` PhoneNumberUsageType[]
- `status` 'Normal' | 'Pending' | 'PortedIn' | 'Temporary' | 'Unknown' — Status of a phone number. If the value is 'Normal', the phone number is ready to be used. Otherwise, it is an external number not yet ported to RingCentral
- `tollType` 'Toll' | 'TollFree' — Indicates if a number is toll or toll-free
- `extensionStatus` 'Enabled' | 'Disabled' | 'Frozen' | 'NotActivated' | 'Unassigned' — Extension status
- `byocNumber` boolean
- `phoneNumber` string

## Response `200`

Successful response

- AccountPhoneNumberList
  - `records` AccountPhoneNumberInfo[], required — List of account phone numbers
    - `id` string, required — Internal unique identifier of a phone number
    - `phoneNumber` string, required — Phone number in e.164 format (with '+' prefix)
    - `type` 'VoiceFax' | 'VoiceOnly' | 'FaxOnly', nullable — Type of phone number
    - `tollType` 'Toll' | 'TollFree', required — Indicates if a number is toll or toll-free
    - `usageType` 'MainCompanyNumber' | 'DirectNumber' | 'Inventory' | 'InventoryPartnerBusinessMobileNumber' | 'PartnerBusinessMobileNumber' | 'AdditionalCompanyNumber' | 'CompanyNumber' | 'PhoneLine' | 'CompanyFaxNumber' | 'ForwardedNumber' | 'ForwardedCompanyNumber' | 'ContactCenterNumber' | 'ConferencingNumber' | 'MeetingsNumber' | 'BusinessMobileNumber' | 'ELIN', required — Usage type of phone number
    - `byocNumber` boolean
    - `status` 'Normal' | 'Pending' | 'PortedIn' | 'Temporary' | 'Unknown', required — Status of a phone number. If the value is 'Normal', the phone number is ready to be used. Otherwise, it is an external number not yet ported to RingCentral
    - `extension` object — Reference to the extension this number is assigned to. Omitted for company numbers
      - `id` string, required — Unique identifier of extension
      - `extensionNumber` string — Short number of an extension. Actual max length depends on system length limit for extension.
  - `paging` EnumeratedPagingModel, required
    - `perPage` integer, required — Current page size, describes how many items are in each page. Matches "perPage" parameter from the request.
    - `page` integer — The current page number. 1-indexed, so the first page is 1 by default. May be omitted if result is empty (because non-existent page was specified or perPage=0 was requested)
    - `pageStart` integer — The zero-based number of the first element on the current page. Omitted if the page is omitted or result is empty
    - `pageEnd` integer — The zero-based index of the last element on the current page. Omitted if the page is omitted or result is empty
    - `totalPages` integer — The total number of pages in a dataset. May be omitted for some resources due to performance reasons
    - `totalElements` integer — The total number of elements in a dataset. May be omitted for some resource due to performance reasons

## Other responses

- `400` — General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `403` — General response with **HTTP 403 "Forbidden"** status.<br> Reasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.
- `404` — General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `429` — General response with **HTTP 429 "Too many requests"** status.<br> Reasons: certain rate limit is exceeded.
- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503` — General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)