jira search jql¶
- Usage:
jira search jql QUERY [flags]
Run an inline JQL query against Jira and print matching issues. Use it when you already have a query string from jira jql build, a saved filter, or a Jira URL.
--web builds and opens the Jira search URL without running the query. --count asks Jira for an approximate match count without fetching issues. --all drains pages with default caps unless --unbounded is set.
Pagination¶
--all¶
Walk every page until isLast (bounded; use --unbounded to lift the caps)
--cursor <TOKEN>¶
Resume from a nextCursor returned by a previous page
--limit <N>¶
Page size requested from Jira; 0 uses the default
Default: 50
--unbounded¶
With --all, lift the default 100-page / 10 000-issue caps
Output¶
--count¶
Return only the approximate match count, without fetching issues
--fields <FIELD>…¶
Narrow each issue to these fields, comma-separated [example: summary,status,assignee]
--full¶
Request Jira's full issue payload (*all fields)
--web¶
Open the query in a browser instead of printing results
Output fields¶
With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.
| Field | Type | Description |
|---|---|---|
issues |
||
jql |
string | |
opened |
boolean | |
source |
string | |
url |
string |
Examples¶
jira search jql "status = Done AND assignee = currentUser()"
jira search jql "project = PROJ" --fields summary,status # (1)!
jira search jql "project = PROJ" --count # (2)!
jira search jql "project = PROJ AND status != Done" --fields key,summary,status --output=json # (3)!
- Select only the fields you need
- Ask Jira for an approximate count without fetching issues
- Restrict fields and keep the result parseable