---
title: "Get all application roles"
method: GET
path: "/rest/api/3/applicationrole"
tags: ["Application roles"]
---

# Get all application roles

`GET /rest/api/3/applicationrole`

Returns all application roles. In Jira, application roles are managed using the [Application access configuration](https://confluence.atlassian.com/x/3YxjL) page.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Response `200`

Returned if the request is successful.

- ApplicationRole[]
  - `defaultGroups` string[] — The groups that are granted default access for this application role. As a group's name can change, use of `defaultGroupsDetails` is recommended to identify a groups.
  - `defaultGroupsDetails` GroupName[] — The groups that are granted default access for this application role.
    - `groupId` string, nullable — The ID of the group, which uniquely identifies the group across all Atlassian products. For example, *952d12c3-5b5b-4d04-bb32-44d383afc4b2*.
    - `name` string — The name of group.
    - `self` string, uri — The URL for these group details.
  - `defined` boolean — Deprecated.
  - `groupDetails` GroupName[] — The groups associated with the application role.
    - `groupId` string, nullable — The ID of the group, which uniquely identifies the group across all Atlassian products. For example, *952d12c3-5b5b-4d04-bb32-44d383afc4b2*.
    - `name` string — The name of group.
    - `self` string, uri — The URL for these group details.
  - `groups` string[] — The groups associated with the application role. As a group's name can change, use of `groupDetails` is recommended to identify a groups.
  - `hasUnlimitedSeats` boolean
  - `key` string — The key of the application role.
  - `name` string — The display name of the application role.
  - `numberOfSeats` integer — The maximum count of users on your license.
  - `platform` boolean — Indicates if the application role belongs to Jira platform (`jira-core`).
  - `remainingSeats` integer — The count of users remaining on your license.
  - `selectedByDefault` boolean — Determines whether this application role should be selected by default on user creation.
  - `userCount` integer — The number of users counting against your license.
  - `userCountDescription` string — The [type of users](https://confluence.atlassian.com/x/lRW3Ng) being counted against your license.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user is not an administrator.

---

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