Skip to content

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

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>…

Issue fields to request from Jira, 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

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)!
  1. Select only the fields you need
  2. Ask Jira for an approximate count without fetching issues
  3. Restrict fields and keep the result parseable