---
title: "Get priority schemes"
method: GET
path: "/rest/api/3/priorityscheme"
tags: ["Priority schemes"]
---

# Get priority schemes

`GET /rest/api/3/priorityscheme`

Returns a [paginated](#pagination) list of priority schemes.

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

## Query parameters

- `startAt` string
- `maxResults` string
- `priorityId` integer[]
- `schemeId` integer[]
- `schemeName` string
- `onlyDefault` boolean
- `orderBy` 'name' | '+name' | '-name'
- `expand` string

## Response `200`

Returned if the request is successful.

- PageBeanPrioritySchemeWithPaginatedPrioritiesAndProjects — A page of items.
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string, uri — If there is another page of results, the URL of the next page.
  - `self` string, uri — The URL of the page.
  - `startAt` integer — The index of the first item returned.
  - `total` integer — The number of items returned.
  - `values` PrioritySchemeWithPaginatedPrioritiesAndProjects[] — The list of items.
    - `default` boolean
    - `defaultPriorityId` string — The ID of the default issue priority.
    - `description` string — The description of the priority scheme
    - `id` string, required — The ID of the priority scheme.
    - `isDefault` boolean
    - `name` string, required — The name of the priority scheme
    - `priorities` PageBeanPriorityWithSequence — A page of items.
      - `isLast` boolean — Whether this is the last page.
      - `maxResults` integer — The maximum number of items that could be returned.
      - `nextPage` string, uri — If there is another page of results, the URL of the next page.
      - `self` string, uri — The URL of the page.
      - `startAt` integer — The index of the first item returned.
      - `total` integer — The number of items returned.
      - `values` PriorityWithSequence[] — The list of items.
        - `description` string — The description of the issue priority.
        - `iconUrl` string — The URL of the icon for the issue priority.
        - `id` string — The ID of the issue priority.
        - `isDefault` boolean — Whether this priority is the default.
        - `name` string — The name of the issue priority.
        - `self` string — The URL of the issue priority.
        - `sequence` string — The sequence of the issue priority.
        - `statusColor` string — The color used to indicate the issue priority.
    - `projects` PageBeanProjectDetails — A page of items.
      - `isLast` boolean — Whether this is the last page.
      - `maxResults` integer — The maximum number of items that could be returned.
      - `nextPage` string, uri — If there is another page of results, the URL of the next page.
      - `self` string, uri — The URL of the page.
      - `startAt` integer — The index of the first item returned.
      - `total` integer — The number of items returned.
      - `values` ProjectDetails[] — The list of items.
        - `avatarUrls` AvatarUrlsBean
          - `16x16` string, uri — The URL of the item's 16x16 pixel avatar.
          - `24x24` string, uri — The URL of the item's 24x24 pixel avatar.
          - `32x32` string, uri — The URL of the item's 32x32 pixel avatar.
          - `48x48` string, uri — The URL of the item's 48x48 pixel avatar.
        - `id` string — The ID of the project.
        - `key` string — The key of the project.
        - `name` string — The name of the project.
        - `projectCategory` UpdatedProjectCategory — A project category.
          - `description` string — The name of the project category.
          - `id` string — The ID of the project category.
          - `name` string — The description of the project category.
          - `self` string — The URL of the project category.
        - `projectTypeKey` 'software' | 'service_desk' | 'business' — The [project type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes) of the project.
        - `self` string — The URL of the project details.
        - `simplified` boolean — Whether or not the project is simplified.
    - `self` string — The URL of the priority scheme.

## Other responses

- `400` — Returned if the request isn't valid.
- `401` — Returned if the authentication credentials are incorrect.

---

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