List Issues
Search for issues using JQL.
Note: Recent updates might not be immediately visible in the returned search results, if you need to read immediately after write, you can use the Reconcile Issues parameter to ensure stronger consistency assurances.
Permissions required:
Browse projects(for the project containing the issue).- If issue-level security is configured, the user needs permissions to view the issue.
External Documentation
To learn more, visit the Jira documentation.
Basic Parameters
| Parameter | Description |
|---|---|
| Fields | A comma-separated list of fields to return for each issue. Options: (Defaults to id)* *all - Returns all fields.* *navigable - Returns navigable fields.* id - Returns only issue IDs.* Any issue field, prefixed with a minus to exclude. Examples: * summary,comment Returns only the summary and comments fields only.* -description Returns all navigable (default) fields except description.* *all,-comment Returns all fields except comments. |
| Limit | The maximum number of items to return per page. |
| Next Page Token | The token for a page to fetch (that is not the first page). Note: The token is not included in the response for the last page (indicating that there is no next page). |
| Query | A JQL expression. Note: This parameter requires a bounded query (with a search restriction). An unbounded expression can be added to the JQL query. Example of a valid bounded query: * project = ‘example’ Example of a mixed query that incorporates both bounded and unbounded expressions: * project = ‘example’ ORDER BY key DESC Note: ORDER BY clause can contain a maximum of 7 fields. |
| Use Instance Timezone | When checked, your Jira instance timezone will be used when writing JQL date filters. |
Advanced Parameters
| Parameter | Description |
|---|---|
| Expand | Select options of additional information to include in the response. Options: * renderedFields - Returns field values rendered in HTML format.* names - Returns the display name of each field.* schema - Returns the schema describing a field type.* transitions - Returns all possible transitions for the issue.* operations - Returns all possible operations for the issue.* editmeta - Returns information about how each field can be edited.* changelog - Returns a list of recent updates to an issue, sorted by date, starting from the most recent.* versionedRepresentations - Returns a JSON array containing each version of a field’s value, with the highest numbered item representing the most recent version. |
| Fail Fast | Select to stop the request early if Jira can’t retrieve all the fields. |
| Fields By Keys | Select to reference the fields by their key (rather than ID). |
| Properties | A comma-separated list of up to 5 issue properties to include in the results. |
| Reconcile Issues | A comma-separated list of IDs, representing issues that require strong consistency reconciliation with search results.(Maximum 50 IDs). |
Example Output
Workflow Library Example
List Issues with Jira and Send Results Via Email
Preview this Workflow on desktop
List Issues
Search for issues using JQL.
Note: Recent updates might not be immediately visible in the returned search results, if you need to read immediately after write, you can use the Reconcile Issues parameter to ensure stronger consistency assurances.
Permissions required:
Browse projects(for the project containing the issue).- If issue-level security is configured, the user needs permissions to view the issue.
External Documentation
To learn more, visit the Jira documentation.
Basic Parameters
| Parameter | Description |
|---|---|
| Fields | A comma-separated list of fields to return for each issue. Options: (Defaults to id)* *all - Returns all fields.* *navigable - Returns navigable fields.* id - Returns only issue IDs.* Any issue field, prefixed with a minus to exclude. Examples: * summary,comment Returns only the summary and comments fields only.* -description Returns all navigable (default) fields except description.* *all,-comment Returns all fields except comments. |
| Limit | The maximum number of items to return per page. |
| Next Page Token | The token for a page to fetch (that is not the first page). Note: The token is not included in the response for the last page (indicating that there is no next page). |
| Query | A JQL expression. Note: This parameter requires a bounded query (with a search restriction). An unbounded expression can be added to the JQL query. Example of a valid bounded query: * project = ‘example’ Example of a mixed query that incorporates both bounded and unbounded expressions: * project = ‘example’ ORDER BY key DESC Note: ORDER BY clause can contain a maximum of 7 fields. |
| Use Instance Timezone | When checked, your Jira instance timezone will be used when writing JQL date filters. |
Advanced Parameters
| Parameter | Description |
|---|---|
| Expand | Select options of additional information to include in the response. Options: * renderedFields - Returns field values rendered in HTML format.* names - Returns the display name of each field.* schema - Returns the schema describing a field type.* transitions - Returns all possible transitions for the issue.* operations - Returns all possible operations for the issue.* editmeta - Returns information about how each field can be edited.* changelog - Returns a list of recent updates to an issue, sorted by date, starting from the most recent.* versionedRepresentations - Returns a JSON array containing each version of a field’s value, with the highest numbered item representing the most recent version. |
| Fail Fast | Select to stop the request early if Jira can’t retrieve all the fields. |
| Fields By Keys | Select to reference the fields by their key (rather than ID). |
| Properties | A comma-separated list of up to 5 issue properties to include in the results. |
| Reconcile Issues | A comma-separated list of IDs, representing issues that require strong consistency reconciliation with search results.(Maximum 50 IDs). |
Example Output
Workflow Library Example
List Issues with Jira and Send Results Via Email
Preview this Workflow on desktop