---
title: "Get issue picker suggestions"
method: GET
path: "/rest/api/3/issue/picker"
tags: ["Issue search"]
---

# Get issue picker suggestions

`GET /rest/api/3/issue/picker`

Returns lists of issues matching a query string. Use this resource to provide auto-completion suggestions when the user is looking for an issue using a word or string.

This operation returns two lists:

 *  `History Search` which includes issues from the user's history of created, edited, or viewed issues that contain the string in the `query` parameter.
 *  `Current Search` which includes issues that match the JQL expression in `currentJQL` and contain the string in the `query` parameter.

This operation can be accessed anonymously.

**[Permissions](#permissions) required:** None.

## Query parameters

- `query` string
- `currentJQL` string
- `currentIssueKey` string
- `currentProjectId` string
- `showSubTasks` boolean
- `showSubTaskParent` boolean

## Response `200`

Returned if the request is successful.

- IssuePickerSuggestions — A list of issues suggested for use in auto-completion.
  - `sections` IssuePickerSuggestionsIssueType[] — A list of issues for an issue type suggested for use in auto-completion.
    - `id` string — The ID of the type of issues suggested for use in auto-completion.
    - `issues` SuggestedIssue[] — A list of issues suggested for use in auto-completion.
      - `id` integer — The ID of the issue.
      - `img` string — The URL of the issue type's avatar.
      - `key` string — The key of the issue.
      - `keyHtml` string — The key of the issue in HTML format.
      - `summary` string — The phrase containing the query string in HTML format, with the string highlighted with HTML bold tags.
      - `summaryText` string — The phrase containing the query string, as plain text.
    - `label` string — The label of the type of issues suggested for use in auto-completion.
    - `msg` string — If no issue suggestions are found, returns a message indicating no suggestions were found,
    - `sub` string — If issue suggestions are found, returns a message indicating the number of issues suggestions found and returned.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)