---
title: "Check issues against JQL"
method: POST
path: "/rest/api/2/jql/match"
tags: ["Issue search"]
---

# Check issues against JQL

`POST /rest/api/2/jql/match`

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

**[Permissions](#permissions) required:** None, however, issues are only matched against JQL queries where the user has:

 *  *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

## Request body

- IssuesAndJQLQueries — List of issues and JQL queries.
  - `issueIds` integer[], required — A list of issue IDs.
  - `jqls` string[], required — A list of JQL queries.

## Response `200`

Returned if the request is successful.

- IssueMatches — A list of matched issues or errors for each JQL query, in the order the JQL queries were passed.
  - `matches` IssueMatchesForJQL[], required
    - `errors` string[], required — A list of errors.
    - `matchedIssues` integer[], required — A list of issue IDs.

## Other responses

- `400` — Returned if `jqls` exceeds the maximum number of JQL queries or `issueIds` exceeds the maximum number of issue IDs.

---

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