Search priorities - JIRA 7.6.1

Returns a paginated 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.

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.

Permissions required: Permission to access Jira.

{"maxResults":50,"startAt":0,"total":2,"isLast":true,"values":[{"self":"https://your-domain.atlassian.net/rest/api/3/priority/3","statusColor":"#009900","description":"Major loss of function.","iconUrl":"https://your-domain.atlassian.net/images/icons/priorities/major.png","name":"Major","id":"1","isDefault":true},{"self":"https://your-domain.atlassian.net/rest/api/3/priority/5","statusColor":"#cfcfcf","description":"Very little impact.","iconUrl":"https://your-domain.atlassian.net/images/icons/priorities/trivial.png","name":"Trivial","id":"2","isDefault":false}]}

Request

Query Params

startAt

string

optional

The index of the first item to return in a page of results (page offset).

maxResults

string

optional

The maximum number of items to return per page.

array[string]

optional

The list of priority IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=2&id=3.

onlyDefault

string

optional

Whether only the default priority is returned.

Responses

🟢200Returned if the request is successful.

application/json

Body

A page of items.

isLast

boolean

read-onlyoptional

Whether this is the last page.

maxResults

integer <int32>

read-onlyoptional

The maximum number of items that could be returned.

string <uri>

read-onlyoptional

If there is another page of results, the URL of the next page.

self

string <uri>

read-onlyoptional

The URL of the page.

startAt

integer <int64>

read-onlyoptional

The index of the first item returned.

total

integer <int64>

read-onlyoptional

The number of items returned.

values

array[object (Priority) {8}]

read-onlyoptional

The list of items.

description

string

optional

The description of the issue priority.

iconUrl

string

optional

The URL of the icon for the issue priority.

string

optional

The ID of the issue priority.

isDefault

boolean

optional

Whether this priority is the default.

name

string

optional

The name of the issue priority.

self

string

optional

The URL of the issue priority.

statusColor

string

optional

The color used to indicate the issue priority.

Additional properties

integer | number | string | boolean

optional

🟠401Returned if the authentication credentials are incorrect or missing.