The Company service belongs to the RISK API and allows, starting from the fiscal code parameter, to verify the presence of negativity against a Company.

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 be passed in the body of the call are:

• fiscal code
• callback (optional)

This is an example of the parameters needed for a request with fiscal code 12485671007:

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

The response is asynchronous. It is possible to set a callback during the request phase to be updated when the data is available, without having to repeatedly call the GET /richiesta/{id} endpoint 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, which can be used in a second call to obtain the desired data.

{
    "data": {
      "cf_piva": "12485671007",
      "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 obtain the data, it will be necessary to make a second request, as previously mentioned, to another endpoint with the previously obtained ID.

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

EXAMPLE RESPONSE GET /IT-richiesta/{id}

In the response, it will be possible to see if the following negative events are present:

• protests
• prejudicial acts
• 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": "12485671007",
      "tipo": [
        "negativita"
      ],
      "callback": true
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1625232029,
      "owner": "[email protected]",
      "soggetto": {
        "code": "12485671007",
        "negativita": {
          "protesti": false,
          "procedure": null,
          "pregiudizievoli":  "ROMA (RM)",
        },
      }  
    },
    "success": true,
    "message": "",
    "error": null
  }
  

The Risk Negative Events service is also available for searches on Individuals and Freelancers.

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

CONDITIONS AND TERMS OF SERVICE USAGE

Despite being available in automatic mode via API, the service 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 weekdays
• The rate limit is automatically configured for each customer based on the annual volumes purchased

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

The service, as per the contractual terms, has daily rate limit constraints set for proper service management.

If you wish to have a customized service, contact us here.