---
title: "Get project issue type hierarchy"
method: GET
path: "/rest/api/2/project/{projectId}/hierarchy"
tags: ["Projects"]
---

# Get project issue type hierarchy

`GET /rest/api/2/project/{projectId}/hierarchy`

Get the issue type hierarchy for a next-gen project.

The issue type hierarchy for a project consists of:

 *  *Epic* at level 1 (optional).
 *  One or more issue types at level 0 such as *Story*, *Task*, or *Bug*. Where the issue type *Epic* is defined, these issue types are used to break down the content of an epic.
 *  *Subtask* at level -1 (optional). This issue type enables level 0 issue types to be broken down into components. Issues based on a level -1 issue type must have a parent issue.

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

## Path parameters

- `projectId` integer, required

## Response `200`

Returned if the request is successful.

- ProjectIssueTypeHierarchy — The hierarchy of issue types within a project.
  - `hierarchy` ProjectIssueTypesHierarchyLevel[] — Details of an issue type hierarchy level.
    - `entityId` string, uuid — The ID of the issue type hierarchy level. This property is deprecated, see [Change notice: Removing hierarchy level IDs from next-gen APIs](https://developer.atlassian.com/cloud/jira/platform/change-notice-removing-hierarchy-level-ids-from-next-gen-apis/).
    - `issueTypes` IssueTypeInfo[] — The list of issue types in the hierarchy level.
      - `avatarId` integer — The avatar of the issue type.
      - `id` integer — The ID of the issue type.
      - `name` string — The name of the issue type.
    - `level` integer — The level of the issue type hierarchy level.
    - `name` string — The name of the issue type hierarchy level.
  - `projectId` integer — The ID of the project.

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `404` — Returned if the project is not found or the user does not have the necessary permission.

---

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