Freelancer negativity information check - Italy

Currently the negativity service is not available, we are working on releasing the new service shortly. If you are interested in verifying the negativity of a private individual or company, however, the Visengine API is available through which you can request protests report.

Freelancer negativity information check generally refer to all events with legal/economic value that may indicate a risk or issue related to a person or company.

Typically considered negative events are:

The Check Risk for Freelancers (All) check service is part of the RISK API and allows you to check, using the fiscal code parameter, the presence of negativities against a Professional.

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

REQUEST EXAMPLE

POST/negativita

The method to use for the request is POST:

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

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

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

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

The response is asynchronous. It is possible to set up a callback during the request to be updated when the data becomes available, without having to call the endpoint GET/request/{id} multiple times to check its status. If a callback is set, headers is a mandatory field and can be used to specify all headers that the user wants to be returned in the callback (e.g., session_id).

RESPONSE EXAMPLE

POST/negativita

The response will provide the request ID to be used in a second call to obtain the desired data.

{
        "data": {
          "cf_piva": "DRSCLD70P15H501V",
          "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
      }

REQUEST EXAMPLE

GET/IT-richiesta/{id}

To obtain the data, a second request will need to be made, as previously mentioned, to a different endpoint using the previously obtained ID.

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

RESPONSE EXAMPLE

GET/IT-request/{id}

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

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

In addition to checking for presence, it is possible to obtain complete details of negative records through protest checks, prejudicial records, and insolvency procedures that can be requested with the API Visengine.

These documents are available in PDF, JSON, and XML formats.