---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# JSONv2 web service

# JSONv2 web service {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

The ability to describe sets of data in JSON format is a
natural extension to the JavaScript language.

ServiceNow supports a web service
interface that operates on the JSON object as the data input and output format.  
The JSONv2 web service is provided by a platform-level processor similar to the services for SOAP, WSDL, CSV, Excel, and XML. Like those services, the JSON web service is triggered by a standalone JSONv2 URL parameter. For example:

    https://<instance name>.service-now.com/mytable.do?JSONv2

Having the JSON object available as a data format for web services means that you can create
(insert), update, and query any data in the system using the JSON object format, and get results
in the JSON object format.

## Security

Like all other HTTP-based web services available on the platform, the JSONv2 web service is
required to authenticate using
basic
authentication by default. The user ID that is used for authentication is subjected to access
control in the same way as an interactive user.
* **[JSON object format](https://servicenow-prod.fluidtopics.net/ZfYfMqxb324bkhWe1yoFAw)**   
  The JSON object is built in two structures.
* **[JSON response status](https://servicenow-prod.fluidtopics.net/u49ozX7rpKFsYZj9FJtq2w)**   
  JSONv2 requests may return one of several response statuses.
* **[Setting the number of rows returned](https://servicenow-prod.fluidtopics.net/_Mo2_i_YCyd2P452jz3rIg)**   
  The following system property controls how many rows JSON returns with each query.
* **[Requiring basic authentication for incoming JSONv2 requests](https://servicenow-prod.fluidtopics.net/QZ~1CBAO7SqYanD9KBkuAA)**   
  The following system property controls whether basic authentication is required for incoming JSONv2 requests.
* **[Action parameters](https://servicenow-prod.fluidtopics.net/jSxayKKholRGSmsSA8coqw)**   
  Action parameters are separate and different from data parameters because they specify the action to take when the JSON object parameter is part of an HTTP GET or POST request.
* **[JSON Data Retrieval API](https://servicenow-prod.fluidtopics.net/Ts12CWmUsFYAc4F0dD7J7w)**   
  Query for data by issuing an HTTPS GET request to the instance.
* **[JSON Data Modification API](https://servicenow-prod.fluidtopics.net/XF0KiYmDqJTj2SISRDehgw)**   
  Modify data using the JSON web service by sending an HTTPS POST request to the instance.

**Related concepts**   

* [SOAP web services security](https://servicenow-prod.fluidtopics.net/sTBQth13zJB9qSZPTI08ng "Simple Object Access Protocol (SOAP) is an XML-based protocol for accessing web services over HTTP.")