---
title: "Get permission scheme grants"
method: GET
path: "/rest/api/3/permissionscheme/{schemeId}/permission"
tags: ["Permission schemes"]
---

# Get permission scheme grants

`GET /rest/api/3/permissionscheme/{schemeId}/permission`

Returns all permission grants for a permission scheme.

**[Permissions](#permissions) required:** Permission to access Jira.

## Path parameters

- `schemeId` integer, required

## Query parameters

- `expand` string

## Response `200`

Returned if the request is successful.

- PermissionGrants — List of permission grants.
  - `expand` string — Expand options that include additional permission grant details in the response.
  - `permissions` PermissionGrant[] — Permission grants list.
    - `holder` PermissionHolder — Details of a user, group, field, or project role that holds a permission. See [Holder object](../api-group-permission-schemes/#holder-object) in *Get all permission schemes* for more information.
      - `expand` string — Expand options that include additional permission holder details in the response.
      - `parameter` string — As a group's name can change, use of `value` is recommended. The identifier associated withthe `type` value that defines the holder of the permission.
      - `type` string, required — The type of permission holder.
      - `value` string — The identifier associated with the `type` value that defines the holder of the permission.
    - `id` integer — The ID of the permission granted details.
    - `permission` string — The permission to grant. This permission can be one of the built-in permissions or a custom permission added by an app. See [Built-in permissions](../api-group-permission-schemes/#built-in-permissions) in *Get all permission schemes* for more information about the built-in permissions. See the [project permission](https://developer.atlassian.com/cloud/jira/platform/modules/project-permission/) and [global permission](https://developer.atlassian.com/cloud/jira/platform/modules/global-permission/) module documentation for more information about custom permissions.
    - `self` string, uri — The URL of the permission granted details.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if the permission schemes is not found or the user does not have the necessary permission.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-3/versions/5a51740d7ab3/schema)