---
title: "Search priorities"
method: GET
path: "/rest/api/3/priority/search"
tags: ["Issue priorities"]
---

# Search priorities

`GET /rest/api/3/priority/search`

Returns a [paginated](#pagination) list of priorities. The list can contain all priorities or a subset determined by any combination of these criteria:

 *  a list of priority IDs. Any invalid priority IDs are ignored.
 *  a list of project IDs. Only priorities that are available in these projects will be returned. Any invalid project IDs are ignored.
 *  whether the field configuration is a default. This returns priorities from company-managed (classic) projects only, as there is no concept of default priorities in team-managed projects.

**Deprecation notice:** The `onlyDefault` parameter is deprecated and will be removed at a later date. See [CHANGE-1655](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-1655).

**Deprecation notice:** The `isDefault` property of priorities is deprecated and will be removed at a later date. See [CHANGE-1655](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-1655).

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

## Query parameters

- `startAt` string
- `maxResults` string
- `id` string[]
- `projectId` string[]
- `priorityName` string
- `onlyDefault` boolean
- `expand` string

## Response `200`

Returned if the request is successful.

- PageBeanPriority — 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` Priority[] — The list of items.
    - `avatarId` integer — The avatarId of the avatar for the issue priority. This parameter is nullable and when set, this avatar references the universal avatar APIs.
    - `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.
    - `schemes` ExpandPrioritySchemePage
      - `maxResults` integer
      - `startAt` integer
      - `total` integer
    - `self` string — The URL of the issue priority.
    - `statusColor` string — The color used to indicate the issue priority.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.

---

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