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:
- Using REST API
- Integration with External Systems
- 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.
- Select> Issues > Issue Types
- Find an issue type you are interested in and click ⋯ > Edit
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.
- Navigate to the project, then clickProject Settings > Issue Types
- Find an issue type you are interested in and click on it.
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 GET \
--url 'https://<SITENAME>.atlassian.net/rest/api/3/project/{projectIdOrKey}' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
...
"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.