---
title: "Get project usages by status"
method: GET
path: "/rest/api/2/statuses/{statusId}/projectUsages"
tags: ["Status"]
---

# Get project usages by status

`GET /rest/api/2/statuses/{statusId}/projectUsages`

Returns a page of projects using a given status.

## Path parameters

- `statusId` string, required

## Query parameters

- `nextPageToken` string
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- StatusProjectUsageDTO — The projects using this status.
  - `projects` StatusProjectUsagePage — A page of projects.
    - `nextPageToken` string — Page token for the next page of issue type usages.
    - `values` StatusProjectUsage[] — The list of projects.
      - `id` string — The project ID.
  - `statusId` string — The status ID.

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing, or the caller doesn't have permissions to perform the operation.
- `404` — Returned if the status with the given ID does not exist.

---

[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)