Company Negativity Info Check

The Company Negativity Info Check service is part of the RISK API and allows, starting from the tax code, to check for any negative information concerning a company.

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

REQUEST EXAMPLE

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 call are:

Here is an example of the parameters needed for a request with tax 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 will be 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 declare all the headers that the user wants to be returned in the callback (such as session_id).

RESPONSE EXAMPLE

POST/negativita

The response will include the request ID to 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": "test@openapi.com",
      "id": "60e866b6b3178c6dc80adf8e",
      "soggetto": "null",
      "status": "PENDING",
      "date_request": "null",
      "date_completion": "null"
      }
    },
    "success": true,
    "message": "",
    "error": null
  }

REQUEST EXAMPLE

GET /IT-request/{id}

To obtain the data, a second request will be necessary, as mentioned earlier, to another endpoint with the ID previously obtained.

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

RESPONSE EXAMPLE

GET /IT-request/{id}

The response will indicate whether 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": "12485671007",
      "type": [
        "negatives"
      ],
      "callback": true
      "outcome": {
        "code": 200,
        "info": "OK"
      },
     
      "timestamp": 1625232029,
      "owner": "test@openapi.it",
      "subject": {
        "code": "12485671007",
        "negatives": {
          "protests": true,
          "proceedings": false,
          "prejudicial":  false
        },
      }  
    },
    "success": true,
    "message": "",
    "error": null
  }
  

In addition to verifying the presence of negative events, you can obtain complete details of negatives through protests, prejudicials, and insolvency proceedings that can be requested with the Visengine API. These documents are available in PDF, JSON, and XML formats.

CONDITIONS AND TERMS OF USE OF THE SERVICE

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

Requests made at other times or days will be queued and processed on a priority basis on the first working day.

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

If you want a personalized service, contact us here.