The response to every API call is a JSON object which consists of the following fields:


url – The URL of “GetData” file on the server obtained from the _js_url configuration parameter. This is the location to which the client side parameters (result of the embedded Javascript) are posted. This URL points to a service which forwards the data to ShieldSquare servers.


pid – Page ID is a unique ID assigned to every API call.

dynamic_JS – The value for this field is a Dynamic JavaScript code snippet which is a real time challenge thrown to distinguish browsers from the bad bots.

responsecode – The response code is a code which indicates the action to be taken on a request.


reason* – This field contains an error message if the response code returned is -1.