The Negative Events Person service is part of the API RIS and allows, starting from the parameter tax code, to verify the presence of negative events concerning a person.

The service is identified by the endpoint https://risk.openapi.com/IT-negativita.

EXAMPLE REQUEST POST /negativita

The method to use in the request is POST:

POST https://risk.openapi.com/IT-negativita

The parameters to pass in the body of the request are:

• fiscal code
• callback (optional)

This is an example of the parameters required for a request with the fiscal code RSSMRA90D15L

{
  "cf_piva": "RSSMRA90D15L117D",  
  "callback": {
    "url": "https://yourdomain.com/your_script",
    "field": "data",
    "method": "POST",
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }
}

The response is asynchronous. It is possible, at the time of the request, to set a callback to be updated when the data is available, without having to call the GET /richiesta/{id} endpoint multiple times to check its status. If a callback is set, 'headers' is a mandatory field and can be used to declare all the headers that the user wants to be returned in the callback (such as session_id).

EXAMPLE RESPONSE POST /negativita

The response will include the request id to be used in a second call to obtain the desired data:

{
    "data": {
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "negativita"
      ],
      "callback": true,
      "url" https://yourdomain.com/your_script,
      "field" data,
      "method" POST,
      "data": false,
      "headers": {
        "session_id": ""oiwejdf89453urf945jfg""
      }
      "esito": "null"
      "timestamp": "1717073284",
      "owner": "[email protected]",
      "id": "60e866b6b3178c6dc80adf8e",
      "soggetto": "null",
      "status": "PENDING",
      "date_request": "null",
      "date_completion": "null",
      },
    "success": true,
    "message": "",
    "error": null
  }

EXAMPLE REQUEST GET /IT-richiesta/{id}

To get the data, it will be necessary to make a second request, as previously mentioned, to another endpoint using the previously obtained ID.

POST https://risk.openapi.com/IT-richiesta/60e866b6b3178c6dc80adf8e 

EXAMPLE RESPONSE GET /IT-richiesta/{id}

The response will indicate if the following negative events are present:

• protests
• prejudicial actions
• insolvency proceedings

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2024-04-09 17:09:42",
      "date_completion": "2024-04-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "negativita"
      ],
      "callback": true
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1625232029,
      "owner": "[email protected]",
      "soggetto": {
        "code": "RSSMRA90D15L117D",
        "negativita": {
          "protesti": true,
          "procedure": false,
          "pregiudizievoli":  false
        },
      }  
    },
    "success": true,
    "message": "",
    "error": null
  }
  

The "Negative Events Person-Risk" service is also available for searches on Freelance Professionals and Companies.

In addition to presence verification, full details of negatives can be obtained through the protests, prejudicial records, and bankruptcy proceedings that can be requested with the Visengine API. These documents are available in pdf, JSON and XML formats

CONDITIONS AND USAGE OF THE SERVICE

Although the service is available automatically via API, it is subject to continuous LOG monitoring due to regulatory reasons, with the following limitations:

• The service is active from 9 AM to 7 PM
• The service is active only on working days
• The rate limit is automatically configured per customer based on the annual volumes purchased

Requests made outside these hours or on non-working days are queued and processed with priority on the next working day.

As per contractual conditions, the service has daily rate limit constraints for proper service management.
These limits vary based on the subscription:

If you want a personalized service, contact us here.