---
title: "Get Permission"
method: GET
path: "/restapi/v1.0/dictionary/permission/{permissionId}"
tags: ["User Permissions"]
---

# Get Permission

`GET /restapi/v1.0/dictionary/permission/{permissionId}`

Returns a user permission by ID.

## Path parameters

- `permissionId` string, required

## Response `200`

Permission information

- PermissionResource
  - `uri` string, uri
  - `id` string
  - `displayName` string
  - `description` string
  - `assignable` boolean
  - `readOnly` boolean
  - `siteCompatible` 'Incompatible' | 'Compatible' | 'Independent' — Site compatibility flag set for permission
  - `category` PermissionCategoryIdResource
    - `uri` string, uri
    - `id` string
  - `includedPermissions` 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

---

[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)