What is the key difference between v1 and v2 api

Dhruv Savaj
Tera Contributor

‎11-27-2023 03:15 AM - edited ‎11-27-2023 03:36 AM

Hello,

 

I am new to ServiceNow and am exploring documents. I want to know what the main difference is between the "v1" and "v2" REST APIs.

 

for example:

1) /api/now/v1/account

2) /api/now/v2/account

 

I am using vancouver version with Developer instance

0 Helpfuls
  • 1,995 Views
3 REPLIES 3

Ratnakar7
Mega Sage
Mega Sage

‎11-29-2023 06:47 AM

Hi @Dhruv Savaj ,

 

New versions often introduce additional features and improvements over the previous ones.

The v2 API may have enhancements, bug fixes, or new functionalities that are not present in v1.

Ratnakar7_0-1701269194089.png

Refer: https://developer.servicenow.com/dev.do#!/reference/api/utah/rest/account-api#account-GET?navFilter=...

 

Thanks,

Ratnakar

0 Helpfuls

Dhruv Savaj
Tera Contributor
In response to Ratnakar7

‎11-29-2023 11:35 PM

Hi Ratnakar,

 

I want something like structured differences. Some features and bug fixes are available in the v2 API but not in the v1 API.

Can you please provide any link to an article or table of differences if any is available?

 

Simply put, I want to know which API endpoint I have to use while I am integrating into my project.

 

Thanks,

Dhruv

0 Helpfuls

James_Neale
Mega Guru

‎08-02-2024 12:32 PM

The main difference is just the GET response when fetching a list of records that is empty. v1 returns 404 not found, v2 returns an empty array.

 

Full details in KB0551763: https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0551763

 

James

0 Helpfuls