> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Issues

Searches for issues using [JQL](https://confluence.atlassian.com/x/egORLQ).

## Parameters

<div className="integrations-table">
  | Parameter             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Limit                 | The maximum number of items to return per page.<br /><br />To manage page size, Jira may return fewer items per page where a large number of fields are requested.<br />The greatest number of items returned per page is achieved when requesting `id` or `key` only.                                                                                                                                                                               |
  | Offset                | The index of the first item to return in a page of results (page offset).                                                                                                                                                                                                                                                                                                                                                                            |
  | Query                 | The [JQL](https://confluence.atlassian.com/x/egORLQ) that defines the search. Note:<br /><br /> \*  If no JQL expression is provided, all issues are returned.<br /> \*  `username` and `userkey` cannot be used as search terms due to privacy reasons. Use `accountId` instead.<br /> \*  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 Timezone | When checked, your Jira instance timezone will be used when writing JQL date filters.                                                                                                                                                                                                                                                                                                                                                                |
</div>

## Example Output

```json theme={"dark"}
{
	"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](https://library.blinkops.com/workflows/list-issues-with-jira-data-center-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-issues-with-jira-data-center-and-send-results-via-email/canvas" />
</div>
