# Jira - Search issues by JQL (batch)

The Search issues by JQL batch action retrieves issues from Jira that match a specified JQL query. Use this action to return one or more Jira issues, optionally filter fields, and handle paginated results for large datasets.

ACTION BEHAVIOR

Jira search results may not reflect recent changes. Use the Reconcile issue IDs field to return real-time results for up to 50 issues. Alternatively, add a short delay after steps that create or update records. For example, using the Ruby snippets by Workato sleep function or the Scheduler by Workato Wait for time duration action.

# Input

Input field Description
JQL query string Specify a valid JQL query. Only issues that match the query return. The action fails if no query is entered.
Output fields Select one or more fields to return in the output. Leave blank to return all fields.
Max result Set the number of records to return. Value must be an integer between 1 and 5000. Defaults to 100.
Next page token Provide a token value to return the next page of results. Use this field for pagination.
Reconcile issue IDs Provide up to 50 issue IDs (comma-separated) to return consistent results immediately after updates. Consistency is only ensured for specified issues.

# Output

Output field Description
Expand Additional issue data that was expanded.
Start at Index of the first issue returned.
Max results Number of issues returned in the response.
Total Total number of issues that matched the query.
Next page token Token to use in the Next page token input field to retrieve the next batch.
Issues Array of issue objects that matched the query.


Last updated: 11/12/2025, 8:43:01 PM

On this page