Issue Search

Accessed via jira.search. Search for issues using JQL (Jira Query Language).

enhanced_search

Search for issues using a JQL query. Returns paginated results.

# Basic search
results = jira.search.enhanced_search("project = PROJ ORDER BY created DESC")
print(f"Total results: {results['total']}")

for issue in results["issues"]:
    print(f"{issue['key']}: {issue['fields']['summary']}")

# Request specific fields
results = jira.search.enhanced_search(
    "project = PROJ AND status = 'In Progress'",
    fields=["summary", "status", "assignee"],
    max_results=25,
)

# Paginate through all results
results = jira.search.enhanced_search("project = PROJ", max_results=100)

while results.get("nextPageToken"):
    results = jira.search.enhanced_search(
        "project = PROJ",
        max_results=100,
        next_page_token=results["nextPageToken"],
    )

Parameter	Type	Default	Description
jql	str	required	JQL query string
next_page_token	str \| None	None	Token for fetching the next page of results
max_results	int	50	Maximum items per page
fields	list[str] \| None	None	Fields to return (e.g., ["summary", "status"]). Use ["*all"] for all.
expand	str \| None	None	Comma-separated properties to expand
extra_params	Mapping[str, Any] \| None	None	Additional query parameters
extra_data	Mapping[str, Any] \| None	None	Additional request body data

Returns: dict[str, Any] — search results with issues, total, and nextPageToken.

Jira REST API — Search for issues using JQL enhanced search