# List Phone Numbers

`ringcentral_list-phone-numbers` · RingCentral MCP tool · Diagnostics

List phone numbers assigned to the RingCentral account, both company-level and extension-level. Read-only.

## RingCentral Frequently Asked Questions

**What does the List Phone Numbers tool do?**

This page documents the List Phone Numbers tool (`ringcentral_list-phone-numbers`). List phone numbers assigned to the RingCentral account, both company-level and extension-level. Read-only. It is one of the RingCentral Diagnostics tools, invoked through your firm's Weave MCP connection and available to members whose access level permits it.

**What is the RingCentral integration?**

The RingCentral integration connects your firm's RingCentral account to Weave. RingCentral (RingEX) is a cloud phone/UCaaS platform. This integration exposes read-only call log, call analytics, recordings, directory, extension, and account diagnostics data as governed MCP tools, scoped per member by access level. It groups 17 tools into 5 categories, exposed through your firm's Weave MCP connection and filtered per member by access level.

## Input

- **page** `integer` — Which results page to fetch (1-indexed). Spec default 1, documented range 1-1000; omit for the first page.
- **usageType** `string` (enum: "MainCompanyNumber", "AdditionalCompanyNumber", "CompanyNumber", "DirectNumber", "CompanyFaxNumber", "ForwardedNumber", "ForwardedCompanyNumber", "ContactCenterNumber", "ConferencingNumber", "MeetingsNumber", "BusinessMobileNumber", "PartnerBusinessMobileNumber", "IntegrationNumber") — Only return phone numbers with this usage type.

## Output

- **uri** `string` — Link to this list of account phone numbers.
- **records** `array` — The account's phone numbers, company- and extension-level.
  - **[]** `object`
    - **uri** `string` — Link to the company phone number resource.
    - **id** `integer` — Internal identifier of the phone number.
    - **country** `object` — Country the phone number belongs to.
      - **id** `string` — Internal identifier of the country.
      - **uri** `string` — Canonical URI of the country resource.
      - **name** `string` — The official name of the country.
    - **extension** `object` — The extension this phone number is assigned to, if any.
      - **id** `integer` — Internal identifier of the extension.
      - **uri** `string` — Canonical URI of the extension resource.
      - **name** `string` — Extension name.
      - **extensionNumber** `string` — Extension short number.
      - **partnerId** `string` — Partner-assigned identifier of the extension.
    - **label** `string` — Custom user-defined name of the phone number, if any.
    - **location** `string` — Location (city, state); filled for local US numbers only.
    - **paymentType** `string` — How the number's usage is billed.
    - **phoneNumber** `string` — The phone number.
    - **status** `string` (enum: "Normal", "Pending", "PortedIn", "Temporary") — Status of the phone number.
    - **type** `string` (enum: "VoiceFax", "FaxOnly", "VoiceOnly") — Phone number type.
    - **usageType** `string` — Usage type of the phone number.
    - **temporaryNumber** `object` — Temporary phone number, present only while porting is pending.
      - **id** `string` — Temporary phone number identifier.
      - **phoneNumber** `string` — Temporary phone number, E.164 format.
    - **contactCenterProvider** `object` — Contact center routing provider for this number, if applicable.
      - **id** `string` — Internal identifier of the contact center provider.
      - **name** `string` — Contact center provider's name.
    - **vanityPattern** `string` — Vanity pattern for this number; returned only when a vanity search was requested.
    - **primary** `boolean` — Whether this is the account's primary/main phone number.
    - **callerIdName** `string` — Caller ID name (CNAM) shown for this number. Live-observed on nonprod; not declared by the vendored spec's CompanyPhoneNumberInfo component.
- **navigation** `object` — Links to other pages of this result set.
  - **firstPage** `object` — Link to the first page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
  - **nextPage** `object` — Link to the next page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
  - **previousPage** `object` — Link to the previous page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
  - **lastPage** `object` — Link to the last page of results.
    - **uri** `string` — Canonical URI to retrieve this page of the result set.
- **paging** `object` — Pagination metadata for `records`.
  - **perPage** `integer` (required) — Page size — how many items are in each page.
  - **page** `integer` — Current page number (1-indexed). Omitted if the result is empty.
  - **pageStart** `integer` — Zero-based index of the first element on the current page. Omitted if empty.
  - **pageEnd** `integer` — Zero-based index of the last element on the current page. Omitted if empty.
  - **totalPages** `integer` — Total number of pages in the dataset. May be omitted for some resources for performance.
  - **totalElements** `integer` — Total number of elements in the dataset. May be omitted for some resources for performance.