---
title: "Count issues using JQL"
method: POST
path: "/rest/api/3/search/approximate-count"
tags: ["Issue search"]
---

# Count issues using JQL

`POST /rest/api/3/search/approximate-count`

Provide an estimated count of the issues that match the [JQL](https://confluence.atlassian.com/x/egORLQ). Recent updates might not be immediately visible in the returned output. This endpoint requires JQL to be bounded.

This operation can be accessed anonymously.

**[Permissions](#permissions) required:** Issues are included in the response where the user has:

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

## Request body

- JQLCountRequestBean
  - `jql` string — A [JQL](https://confluence.atlassian.com/x/egORLQ) expression. For performance reasons, this parameter requires a bounded query. A bounded query is a query with a search restriction.

## Response `200`

Returned if the request is successful.

- JQLCountResultsBean
  - `count` integer — Number of issues matching JQL query.

## Other responses

- `400` — Returned if the JQL query cannot be parsed.
- `401` — Returned if the authentication credentials are incorrect.

---

[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/ec7f275dfee5/schema)