Skip to main content

List Issues

Searches for issues using JQL.

Parameters

ParameterDescription
LimitThe maximum number of items to return per page.

To manage page size, Jira may return fewer items per page where a large number of fields are requested.
The greatest number of items returned per page is achieved when requesting id or key only.
OffsetThe index of the first item to return in a page of results (page offset).
QueryThe JQL that defines the search. Note:

If no JQL expression is provided, all issues are returned.
username and userkey cannot be used as search terms due to privacy reasons. Use accountId instead.
* If a user has hidden their email address in their user profile, partial matches of the email address will not find the user. An exact match is required.
Use Instance TimezoneWhen checked, your Jira instance timezone will be used when writing JQL date filters.

Example Output

{
"expand": "names,schema",
"startAt": 0,
"maxResults": 50,
"total": 1,
"issues": [
{
"expand": "",
"id": "10001",
"self": "http://www.example.com/jira/rest/api/2/issue/10001",
"key": "HSP-1"
}
]
}

Workflow Library Example

List Issues with Jira Data Center and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop