Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

For EE Jira 9.17.5, should I use REST API v3 or v2? what the difference?

harry sheng
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!
October 4, 2025

The jira server is EE 9.17.5

I use this endpoint URL (/rest/api/2/issue/<jira-ticket-key>?fields=key,summary) to retrieve the jira ticket info, with Authorization header, and Accept header set to application/json.

It seems the rest server needs warm up. The first couple tries always come back with 500 code (internal server error); eventually the GET request comes back with 200 code, with content in JSON format.

Then I tried with the v3 api (/rest/api/3/issue/<jira-ticket-key>?fields=key,summary) with exactly the same headers. The response code is 200, but the content is in HTML format.

 

3 answers

0 votes
Sunny Ape
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 5, 2025

Hello @harry sheng 

  1. The Jira CLOUD product has both a v2 and v3 version of its REST API.
  2. The Jira DATA CENTER product (what you are accessing) has only a v2 REST API... there is no v3 REST API for that product.

Refer to the Jira DC v9.17.5 REST API documentation.

0 votes
Jayesh
Contributor
October 5, 2025

Hello @harry sheng 

Jira has depcreciated the v2 API, so you need to use the v3 API.

You can get more information on below Atlassian KB articles

https://developer.atlassian.com/server/jira/platform/integrating-with-jira-server/


https://developer.atlassian.com/server/jira/platform/rest/v11001/intro/#gettingstarted

Thanks
Jayesh R

Sunny Ape
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 5, 2025


Jira has depcreciated the v2 API, so you need to use the v3 API.

That is completely wrong @Jayesh 

The v2 REST API absolutely has not been deprecated, and given that the OP is using Jira DATA CENTER, which does not have a v3 REST API, your advice would be impossible for them to follow.

Like Jayesh Raghuvanshi likes this
Jayesh Raghuvanshi
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 6, 2025

@Sunny Ape  Thanks for the clarification, appreciated your response.

0 votes
Jayesh Raghuvanshi
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 5, 2025

Hello @harry sheng 

Yes v2 api is depreciated by Jira you will need to use v3 API only.


Sunny Ape
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 6, 2025

That is completely wrong @Jayesh Raghuvanshi 

The v2 REST API absolutely has not been deprecated, and given that the OP is using Jira DATA CENTER, which does not have a v3 REST API, your advice would be impossible for them to follow.

Suggest an answer

Log in or Sign up to answer