---
title: "List Extension Grants"
method: GET
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/grant"
tags: ["User Settings"]
---

# List Extension Grants

`GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/grant`

Returns the list of extensions with information on grants
given to the current extension regarding them. Currently the list of grants
include: picking up a call, monitoring, calling or receiving a call on behalf
of somebody, call delegation and calling paging groups.

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Query parameters

- `extensionType` 'User' | 'FaxUser' | 'VirtualUser' | 'DigitalUser' | 'Department' | 'Announcement' | 'Voicemail' | 'SharedLinesGroup' | 'PagingOnly' | 'IvrMenu' | 'ApplicationExtension' | 'ParkLocation' | 'Limited' | 'Bot' | 'Room' | 'DelegatedLinesGroup'
- `page` integer
- `perPage` integer

## Response `200`

List of extension grants

- GetExtensionGrantListResponse
  - `uri` string, uri — Link to the list of extension grants
  - `records` GrantInfo[], required — List of extension grants with details
    - `uri` string, uri — Canonical URI of a grant
    - `extension` ExtensionInfoGrants — Extension information
      - `id` string — Internal identifier of an extension
      - `uri` string, uri — Canonical URI of an extension
      - `extensionNumber` string — Extension short number (usually 3 or 4 digits)
      - `name` string — Name of extension
      - `type` 'User' | 'Fax User' | 'VirtualUser' | 'DigitalUser' | 'Department' | 'Announcement' | 'Voicemail' | 'SharedLinesGroup' | 'PagingOnly' | 'IvrMenu' | 'ApplicationExtension' | 'ParkLocation' | 'DelegatedLinesGroup' — Extension type. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology
    - `callPickup` boolean — Specifies if picking up of other extensions' calls is allowed for the extension. If 'Presence' feature is disabled for the given extension, the flag is not returned
    - `callMonitoring` boolean — Specifies if monitoring of other extensions' calls is allowed for the extension. If 'CallMonitoring' feature is disabled for the given extension, the flag is not returned
    - `callOnBehalfOf` boolean — Specifies whether the current extension is able to make or receive calls on behalf of the user referenced in extension object
    - `callDelegation` boolean — Specifies whether the current extension can delegate a call to the user referenced in extension object
    - `groupPaging` boolean — Specifies whether the current extension is allowed to call Paging Only group referenced to in extension object
    - `callQueueSetup` boolean — Specifies whether the current extension is assigned as a Full-Access manager in the call queue referenced in extension object
    - `callQueueMembersSetup` boolean — Specifies whether the current extension is assigned as a Members-Only manager in the call queue referenced in extension object
    - `callQueueMessages` boolean — Specifies whether the current extension is assigned as a Messages Manager in the queue referenced in extension object
    - `callQueueFacSetup` boolean — Specifies whether the current extension is granted *Forward All Calls (FAC)* permission
    - `sharedVoicemails` boolean — Specifies whether the user referenced in extension object is sharing voicemails with the current extension
  - `navigation` PageNavigationModel, required — Links to other pages of the current result set
    - `firstPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `nextPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `previousPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `lastPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
  - `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

---

[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/revisions/8d602198ec97/schema)