Finding the Issue Type ID in Jira Cloud
Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.
Summary
You may need Issue Type IDs (as opposed to issue type name) in scenarios like the following:
- Using REST API
- Integration with External Systems
- Advanced Searching
This documentation covers Cloud versions of Jira only. For instructions using Jira Data Center and/or Server, see the related documentation link.
Retrieve issue type ID from Jira user interface (UI)
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, or follow the lower sequence of steps if you have Project administration privileges.
- Select
> Issues > Issue Types - Find an issue type you are interested in and select ⋯ > Edit
Jira will display the Issue Type ID appended to the URL
For example:
https://<SITENAME>.atlassian.net/secure/admin/EditIssueType!default.jspa?id=<ISSUE_TYPE_ID>Alternative steps for Project Administrators
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 selectProject Settings > Issue Types
- Find an issue type you are interested in and select it
Jira will display the Issue Type ID within the URL
For example:
https://<SITENAME>.atlassian.net/plugins/servlet/project-config/<PROJECT_KEY>/issuetypes/<ISSUE_TYPE_ID>/workflow/editRetrieve issue type ID 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 the endpoint /rest/api/3/project/{projectIdOrKey}
curl --request GET \
--url 'https://<SITENAME>.atlassian.net/rest/api/3/project/{projectIdOrKey}' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'Within the API request return, you'll see the list of issue types associated with that project, along with the type IDs.
...
"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.