---
title: "Search statuses paginated"
method: GET
path: "/rest/api/2/statuses/search"
tags: ["Status"]
---

# Search statuses paginated

`GET /rest/api/2/statuses/search`

Returns a [paginated](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#pagination) list of statuses that match a search on name or project.

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

 *  *Administer projects* [project permission.](https://confluence.atlassian.com/x/yodKLg)
 *  *Administer Jira* [project permission.](https://confluence.atlassian.com/x/yodKLg)

## Query parameters

- `projectId` string
- `startAt` integer
- `maxResults` integer
- `searchString` string
- `statusCategory` string
- `includeGlobalStatuses` boolean

## Response `200`

Returned if the request is successful.

- PageOfStatuses
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string — The URL of the next page of results, if any.
  - `self` string — The URL of this page.
  - `startAt` integer — The index of the first item returned on the page.
  - `total` integer — Number of items that satisfy the search.
  - `values` JiraStatus[] — The list of items.
    - `description` string — The description of the status.
    - `id` string — The ID of the status.
    - `name` string — The name of the status.
    - `scope` StatusScope — The scope of the status.
      - `project` ProjectId, nullable — Project ID details.
        - `id` string, required — The ID of the project.
      - `type` 'PROJECT' | 'GLOBAL', required — The scope of the status. `GLOBAL` for company-managed projects and `PROJECT` for team-managed projects.
    - `statusCategory` 'TODO' | 'IN_PROGRESS' | 'DONE' — The category of the status.

## 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.

---

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