---
title: "Check User Permission"
method: GET
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile/check"
tags: ["User Permissions"]
---

# Check User Permission

`GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile/check`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/authz-profile/check`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/authz-profile/check/get.ts> (a function with typed inputs; its response is checked against the schema)

Checks if a certain user permission is activated for a particular extension.

## Path parameters

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

## Query parameters

- `permissionId` string
- `targetExtensionId` string

## Response `200`

Authorization profile resource

- AuthProfileCheckResource
  - `uri` string, uri
  - `successful` boolean
  - `details` ActivePermissionResource
    - `permission` PermissionIdResource
      - `uri` string, uri
      - `id` string
      - `siteCompatible` 'Compatible' | 'Incompatible' | 'Independent': Site compatibility flag set for permission
      - `readOnly` boolean: Specifies if the permission is editable on UI (if set to `true`) or not (if set to `false`)
      - `assignable` boolean: Specifies if the permission can be assigned by the account administrator
      - `permissionsCapabilities` PermissionsCapabilities: Advanced permissions capabilities. Returned if `advancedPermissions` query parameter is set to `true`.
        - `enabled` boolean: Specifies whether the user is enabled with the listed permission or not
        - `manageEnabled` boolean: Specifies if the user can manage the listed permission and is allowed to enable it on other users
        - `grantEnabled` boolean: Specifies if the users who were enabled with the listed permission can grant it further to other users
    - `effectiveRole` RoleIdResource
      - `uri` string, uri
      - `id` string
    - `scopes` string[]

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)
