# List Extension Phone Numbers

`ringcentral_list-extension-phone-numbers` · RingCentral MCP tool · Identity

List phone numbers used by a particular RingCentral extension: directly-mapped numbers plus company-level numbers usable on the extension's behalf.

## RingCentral Frequently Asked Questions

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

This page documents the List Extension Phone Numbers tool (`ringcentral_list-extension-phone-numbers`). List phone numbers used by a particular RingCentral extension: directly-mapped numbers plus company-level numbers usable on the extension's behalf. It is one of the RingCentral Identity 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

- **id** `string` (required, min length: 1) — Internal identifier of the extension to list phone numbers for (or '~' for the currently authorized extension).

## Output

- **uri** `string` — Link to the user phone number list resource.
- **records** `array` (required) — Phone numbers used by the extension.
  - **[]** `object`
    - **uri** `string` — Link to the user phone number resource.
    - **id** `integer` — Internal identifier of the phone number.
    - **country** `object` — The phone number's country.
      - **id** `string` — Internal identifier of the country.
      - **uri** `string` — Canonical URI of the country resource.
      - **name** `string` — Official name of the country.
    - **contactCenterProvider** `object` — CCRN provider, when applicable.
      - **id** `string` — Internal identifier of the CCRN provider.
      - **name** `string` — Name of the CCRN provider.
    - **extension** `object` — The extension this phone number is assigned to.
      - **id** `integer` — Internal identifier of the extension.
      - **uri** `string` — Canonical URI of the extension.
      - **extensionNumber** `string` — Extension short number.
      - **partnerId** `string` — Partner-assigned identifier of the extension.
      - **type** `string` — Extension type (open string — same extension-type taxonomy as list/get-extension; read-widened defensively).
      - **contactCenterProvider** `object` — CCRN provider, when applicable.
        - **id** `string` — Internal identifier of the CCRN provider.
        - **name** `string` — Name of the CCRN provider.
      - **name** `string` — Extension name.
    - **label** `string` — Custom user-assigned name of the phone number, if any.
    - **location** `string` — Location (city, state); filled for local US numbers.
    - **paymentType** `string` — Payment type of the phone number.
    - **phoneNumber** `string` — The phone number.
    - **primary** `boolean` — Whether this is the primary number (displayed as 'main number', called by default).
    - **status** `string` (enum: "Normal", "Pending", "PortedIn", "Temporary") — Status of the phone number. 'Normal' means ready to use; otherwise an external number not yet ported to RingCentral.
    - **type** `string` (enum: "VoiceFax", "FaxOnly", "VoiceOnly") — Phone number type.
    - **subType** `string` (enum: "Unknown", "VideoPro", "VideoProPlus", "DigitalSignage", "Emergency") — Extension subtype, if applicable.
    - **usageType** `string` — Usage type of the phone number (open string; RC may extend this usage-type taxonomy; 'NumberPool' is never returned by this endpoint).
    - **features** `array` — Features enabled on this phone number.
      - **[]** `string`
    - **callerIdName** `string` — Caller ID name shown for this phone number (live-observed, undocumented field).
- **navigation** `object` (required) — Links to other pages of the result set.
  - **firstPage** `object` — Link to the first page.
    - **uri** `string` — Canonical URI to retrieve this particular page.
  - **nextPage** `object` — Link to the next page.
    - **uri** `string` — Canonical URI to retrieve this particular page.
  - **previousPage** `object` — Link to the previous page.
    - **uri** `string` — Canonical URI to retrieve this particular page.
  - **lastPage** `object` — Link to the last page.
    - **uri** `string` — Canonical URI to retrieve this particular page.
- **paging** `object` (required) — Pagination metadata for `records`.
  - **perPage** `integer` (required) — Page size — how many items are in each page.
  - **page** `integer` — 1-based current page number; omitted if the result is empty.
  - **pageStart** `integer` — 0-based index of the first element on the current page.
  - **pageEnd** `integer` — 0-based index of the last element on the current page.
  - **totalPages** `integer` — Total number of pages in the dataset (may be omitted for performance reasons).
  - **totalElements** `integer` — Total number of elements in the dataset (may be omitted for performance reasons).