Check issues against JQL

POST

/rest/api/3/jql/match

Checks whether one or more issues would be returned by one or more JQL queries.

Permissions required: None, however, issues are only matched against JQL queries where the user has:

Browse projects project permission for the project that the issue is in.

If issue-level security is configured, issue-level security permission to view the issue.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful.

Body

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/jql/match' \
--header 'Content-Type: application/json' \
--data-raw '{
    "issueIds": [
        10001,
        1000,
        10042
    ],
    "jqls": [
        "project = FOO",
        "issuetype = Bug",
        "summary ~ \"some text\" AND project in (FOO, BAR)"
    ]
}'

Response Example

{"matches":[{"matchedIssues":[10000,10004],"errors":[]},{"matchedIssues":[100134,10025,10236],"errors":[]},{"matchedIssues":[],"errors":[]},{"matchedIssues":[],"errors":["Invalid JQL: broken = value"]}]}

Modified at 2025-07-16 07:18:01

Get issue picker suggestions

Currently being removed. Search for issues using JQL (GET)