Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Jira REST API to get projects?

Hi all,

I need help whats the API call in jira to get projects in jira



3 answers

1 accepted

9 votes
Answer accepted
Andy Heinzer
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Apr 05, 2019


Since the original answer was posted to this question Atlassian Cloud has deprecated that specific endpoint (GET /rest/api/2/project).   As such there is another endpoint you can use now to get back your projects via REST in Jira Cloud.

For Jira Cloud:

Since you can no longer use the old endpoint, you can instead use the GET /rest/api/3/project/search to return these projects via a search


For Jira Server:

You can make a REST API call to the endpoint GET /rest/api/2/project.  In Jira Server this endpoint will return to you all the projects which are visible to the user making that REST call.

I hope this helps to clarify how you can do this in both platforms.


From what I can find online, the cloud /rest/api/3/project/search does not have an option for returning ALL projects. Do you know if this possible?

Figured it out;


Like # people like this

I tried this but it still returns max 50 results

Like Alex Rumer likes this
Emilio Marinone
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
Oct 23, 2023

Is Jira Server still using (GET /rest/api/2/project)?

2 votes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Feb 14, 2018

Hi Rajesh,

You would use the following endpoint:


Take a look at the REST API documentation for Get All Projects:


Get all projects

GET /rest/api/2/project

Returns all projects visible for the currently logged in user, ie. all the projects the user has either ‘Browse projects’ or ‘Administer projects’ permission. If no user is logged in, it returns all projects that are visible for anonymous users.

App scope required: READ

Response content type: application/json


Query parameters



Multi-value parameter defining request properties to expand in the response. These are not returned by default. Allowed values:

  • description - description of the project.
  • projectKeys - all project keys associated with the project.
  • lead - project lead. Note, that project lead role is different from project administrator one.
  • issueTypes - issue types associated with the project.
  • url - a URL associated with the project.



Only projects recently accessed by the current user will be returned if this parameter is set. If no user is logged in, recently accessed projects will be returned based on current HTTP session. Maximum count is limited to the specified number, but no more than 20.

Take a look at that and let me know if it helps.



Is it possible to get some projects as the project name starts with "ABC" or "ABC*"?

Andy Heinzer
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Jul 21, 2020

The answer if different between Cloud and Server.  

For Server, there is no REST API endpoint you can query to search by projects like this.

But in Cloud you could use the endpoint of GET /rest/api/3/project/search : Get projects paginated to at least search for projects by name.  Granted this does not let you specify begins with, but instead will search the entire title for any string that you might include in the query parameter of that endpoint.  For example doing a search there of ABC would include any project names that contain that string, not just those that start with that string.

Like Domingos Vargas likes this

@Andy Heinzer - Is there any plans to add the search feature to the Server version?  Some of our customers have many projects and are experiencing slow load times with our product because we are fetching all projects.  A search API would be very beneficial.

Also, is there may be another strategy we could leverage?  Our goal is just to return a list of Project Names and IDs . . . we don't need all the details.

Andy Heinzer
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Jul 13, 2021

Hi @Chris Caspanello 

I have not found an easy way to manage this in Jira Server/Data Center.  The existing server REST API endpoints don't permit you to query or filter down the returned projects in the manner of search at this time. So I created a feature request for this over in

I can certainly understand why this would be useful to have, and seeing that Jira Cloud already does this, it makes sense that this is something that could improve performance in some cases and ease integrations.  Currently, the only way to return a single specific project would be to know either the project key or project id and then call the endpoint GET /rest/api/2/project/{projectIdOrKey} where you can pass that info in the call itself.

Suggest an answer

Log in or Sign up to answer