Get the ID of a Jira project from a web browser
Platform Notice: Data Center Only - This article only applies to Atlassian apps 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
Though we have the option to retrieve the projectID from the database by using the query below it can be time-consuming, as it requires a Jira user to have access to the Database:
select id from project where pkey = '<PROJECT_KEY>';Common cases where you need the numeric ID (not the project key):
REST API calls that require
projectIdrather thanprojectKey.JQL queries referencing project by ID (rare; key is preferred).
Custom field configuration JSON that references a project by numeric ID.
App configuration files that store project bindings by ID.
Retrieve project ID using REST API
You can obtain the project ID via the REST API by accessing the following URL:
<JIRA_BASE_URL>/rest/api/latest/project/<project_key>This will provide all of the metadata for the project(s), including the project ID value, as shown in the example of output below (the project id is 10000 in the example below):
{
"expand": "description,lead,url,projectKeys",
"self": "<JIRA_BASE_URL>/rest/api/latest/project/10000",
"id": "10000",
"key": "SCRUM",
"description": "",
...ℹ️ If you do not provide the project_key then it will return all projects.
ℹ️ It can be helpful to paste the JSON output into a JSON beautifier to improve readability.
If you cannot reach the project's UI but have API access, use the project REST endpoint and look up by key. The endpoint signature is documented in the canonical Jira REST API reference linked in the related-articles section below; the response includes the id field with the numeric ID.
Related Articles
Was this helpful?