---
title: "Get issue limit report"
method: GET
path: "/rest/api/3/issue/limit/report"
tags: ["Issues"]
---

# Get issue limit report

`GET /rest/api/3/issue/limit/report`

Returns all issues breaching and approaching per-issue limits.

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

 *  *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) is required for the project the issues are in. Results may be incomplete otherwise
 *  *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Query parameters

- `isReturningKeys` boolean

## Response `200`

Returned if the request is successful.

- IssueLimitReportResponseBean
  - `entitiesBreachingLimit` object — For each field, the ids of the individual entities breaching the limit, grouped by the id or key of the issue they belong to. Fields that hold a single value, such as description and environment, map to an empty list because the issue itself identifies the breaching content
  - `issuesApproachingLimit` object — A list of ids of issues approaching the limit and their field count
  - `issuesBreachingLimit` object — A list of ids of issues breaching the limit and their field count
  - `limits` object — The fields and their defined limits

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have permission to complete this request.

## Changes

- **2026-08-07** `5a51740d7ab3` — 1 info
  - added the optional property `entitiesBreachingLimit` to the response with the `200` status

[Change history](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/changes/rest/api/3/issue/limit/report/get.md)

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-3/revisions/9029bb1c5ebd/schema)