Finding the ID for Issue Types in Jira Server or Data Center

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

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.


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.

  1. Navigate to Administration > Issues > Issue Types
  2. On that page, hover your mouse cursor over the Edit operation link of an issue type
  3. 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:

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.

  1. Navigate to Project Settings > Issue Types
  2. On that page, hover your mouse cursor over the Issue Type in the left menu
  3. Jira will display the issue type's ID appended to the URL shown in the browser's status bar


For example:

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.

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:

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)



Last modified on Jan 22, 2025

Was this helpful?

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