Finding the ID for Issue Types in Jira Server or Data Center
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
When configuring a mail handler to create issues from email, it is useful to know the IDs of issue types rather than only the issue type names.
This documentation covers Server and Data Center versions of Jira only. To find issue type IDs on Jira Cloud versions, see our related documentation.
Solution
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.
Navigate to Administration > Issues > Issue Types
On that page, hover your mouse cursor over the Edit operation link of an issue type
Jira will display the issue type's ID appended to the URL shown in the browser's status bar
For example, the "id=" value in this URL represents the id of the issue type:
1
http://<your-jira-server>/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 Project Settings > Issue Types
On that page, hover your mouse cursor over the Issue Type in the left menu
Jira will display the issue type's ID appended to the URL shown in the browser's status bar
For example:
1
http://<your-jira-server>/plugins/servlet/project-config/<PROJECT_KEY>/issuetypes/<ISSUE_TYPE_ID>Retrieve 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/2/project/{projectIdOrKey}
The examples below use cURL and jq to parse returned JSON data.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
curl -s -u {username}:{password} \
-X GET \
-H 'Accept: application/json' \
'http://<your-jira-server>/rest/api/2/project/{projectIdOrKey}' | jq '.issueTypes[] | {id, name}'
{
"id": "10002",
"name": "Task"
}
{
"id": "10003",
"name": "Sub-task"
}
{
"id": "10001",
"name": "Story"
}
{
"id": "10004",
"name": "Bug"
}
{
"id": "10000",
"name": "Epic"
}More details about the project/{projectIdOrKey} endpoint can be found at Jira REST API documentation.
Retrieve issue type IDs from Jira Database
This method will not require Jira Administrator permissions, however you will need to have read access to the Jira database.
In order to get list of issue type IDs, you will need to query the issuetype table.
For example:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
jiradb=# select id, pname from issuetype;
id | pname
-------+--------------------------------
10001 | Story
10002 | Task
10003 | Sub-task
10004 | Bug
10100 | Initiative
10101 | Incident
10102 | Service Request
10103 | Service Request with Approvals
10104 | Change
10105 | Problem
10000 | Epic
10200 | New Feature
10201 | Support
(13 rows)Was this helpful?