---
title: "Get all statuses for project"
method: GET
path: "/rest/api/2/project/{projectIdOrKey}/statuses"
tags: ["Projects"]
---

# Get all statuses for project

`GET /rest/api/2/project/{projectIdOrKey}/statuses`

Returns the valid statuses for a project. The statuses are grouped by issue type, as each project has a set of valid issue types and each issue type has a set of valid statuses.

This operation can be accessed anonymously.

**[Permissions](#permissions) required:** *Browse Projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project.

## Path parameters

- `projectIdOrKey` string, required

## Response `200`

Returned if the request is successful.

- IssueTypeWithStatus[]
  - `id` string, required — The ID of the issue type.
  - `name` string, required — The name of the issue type.
  - `self` string, required — The URL of the issue type's status details.
  - `statuses` StatusDetails[], required — List of status details for the issue type.
    - `description` string — The description of the status.
    - `iconUrl` string — The URL of the icon used to represent the status.
    - `id` string — The ID of the status.
    - `name` string — The name of the status.
    - `scope` Scope — The projects the item is associated with. Indicated for items associated with [next-gen projects](https://confluence.atlassian.com/x/loMyO).
      - `project` ProjectDetails — Details about a project.
        - `avatarUrls` AvatarUrlsBean
          - `16x16` string, uri — The URL of the item's 16x16 pixel avatar.
          - `24x24` string, uri — The URL of the item's 24x24 pixel avatar.
          - `32x32` string, uri — The URL of the item's 32x32 pixel avatar.
          - `48x48` string, uri — The URL of the item's 48x48 pixel avatar.
        - `id` string — The ID of the project.
        - `key` string — The key of the project.
        - `name` string — The name of the project.
        - `projectCategory` UpdatedProjectCategory — A project category.
          - `description` string — The name of the project category.
          - `id` string — The ID of the project category.
          - `name` string — The description of the project category.
          - `self` string — The URL of the project category.
        - `projectTypeKey` 'software' | 'service_desk' | 'business' — The [project type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes) of the project.
        - `self` string — The URL of the project details.
        - `simplified` boolean — Whether or not the project is simplified.
      - `type` 'PROJECT' | 'TEMPLATE' — The type of scope.
    - `self` string — The URL of the status.
    - `statusCategory` StatusCategory — A status category.
      - `colorName` string — The name of the color used to represent the status category.
      - `id` integer — The ID of the status category.
      - `key` string — The key of the status category.
      - `name` string — The name of the status category.
      - `self` string — The URL of the status category.
  - `subtask` boolean, required — Whether this issue type represents subtasks.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if the project is not found or the user does not have permission to view it.

---

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