Finding the Issue Type ID in Jira Cloud

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Problem

You may need to know Issue Type ID (as opposed to issue type name) in various scenarios. Some of them may include:

  1. Using REST API
  2. Integration with External Systems
  3. Advanced Searching

Environment

Jira Cloud (for Server please go here)

Solution

Using Jira browser user interface:

Here is how a Jira Administrator can find the ID of an issue type:

You will need to be a Jira Administrator in order to perform these steps. If you do not have Jira Administration privileges, you may contact your Jira Administrator for assistance.

  1. SelectSettings> Issues > Issue Types
  2. Find an issue type you are interested in and click  > Edit
  3. Jira will display the Issue Type ID appended to the URL:

    https://<SITENAME>.atlassian.net/secure/admin/EditIssueType!default.jspa?id=<ISSUE_TYPE_ID>


Here is how a Project Administrator can find the ID of an issue type:

You will need to be a Project Administrator in order to perform these steps. If you do not have Project Administration privileges for the project, you may contact one of the Project's Administrators for assistance.

  1. Navigate to the project, then clickProject Settings > Issue Types
  2. Find an issue type you are interested in and click on it.
  3. Jira will display the Issue Type ID as a part to the URL:

    https://<SITENAME>.atlassian.net/plugins/servlet/project-config/<PROJECT_KEY>/issuetypes/<ISSUE_TYPE_ID>/workflow/edit

Using Jira REST API:

You will need to be a Jira Administrator or Project Administrator in order to perform these steps.

Send a GET request to https://<SITENAME>.atlassian.net/rest/api/3/project/{projectIdOrKey} endpoint:

cURL request example
curl --request GET \
  --url 'https://<SITENAME>.atlassian.net/rest/api/3/project/{projectIdOrKey}' \
  --user 'email@example.com:<api_token>' \
  --header 'Accept: application/json'
Response example
...
"issueTypes":[
      {
         "self":"https://<SITENAME>.atlassian.net/rest/api/3/issuetype/10000",
         "id":"10000",
         "description":"A big user story that needs to be broken down. Created by Jira Software - do not edit or delete.",
         "iconUrl":"https://<SITENAME>.atlassian.net/images/icons/issuetypes/epic.svg",
         "name":"Epic",
         "subtask":false,
         "hierarchyLevel":1
      },
      {
         "self":"https://<SITENAME>.atlassian.net/rest/api/3/issuetype/10004",
         "id":"10004",
         "description":"Functionality or a feature expressed as a user goal.",
         "iconUrl":"https://<SITENAME>.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10315?size=medium",
         "name":"Story",
         "subtask":false,
         "avatarId":10315,
         "hierarchyLevel":0
      },
      {
         "self":"https://<SITENAME>.atlassian.net/rest/api/3/issuetype/10005",
         "id":"10005",
         "description":"A small, distinct piece of work.",
         "iconUrl":"https://<SITENAME>.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10318?size=medium",
         "name":"Task",
         "subtask":false,
         "avatarId":10318,
         "hierarchyLevel":0
      },
...


More details about project/{projectIdOrKey} endpoint can be found in the Jira Cloud REST API documentation.



Last modified on Jan 8, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.