€0.70 + VAT
The service checks for negative information such as protests, prejudices, or insolvency procedures against a Freelancer via API
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.
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).
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
}
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
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.
CONDITIONS AND MODALITIES OF SERVICE USE
Although the service is available automatically via API, it is subject to continuous LOG monitoring due to regulatory requirements with the following limitations:
- the service is active from 9 AM to 7 PM
- the service is active only on business days
- the rate limit is automatically configured for each client based on the annual volumes purchased
Requests made at other times or days will be queued and processed on a priority basis on the next business day.
The service, as per contractual conditions, has daily rate limit constraints set for proper management of the service.
If you wish to have a customized service, contact us here.
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The Freelancer negativity information check (Negatività) service allows you to verify, via API, the presence of negative events such as protests, prejudicial actions, or insolvency proceedings involving a freelancer.
The service is part of Risk, the API that allows access to numerous databases (e.g., Anagrafe, Revenue Agency, Chamber of Commerce, CRIF, Experian) and more than 15 reports and investigations on individuals, freelancers, and companies with a single request.Here are some of the available information via API:
The service identifies protests (non-payment of checks or bills), prejudicial actions in the land registry (mortgages, payment orders, foreclosures), and insolvency proceedings (insolvency status, difficulties in fulfilling obligations).
Yes, the negativity information check service can also be used for searches on companies and individuals.
The Freelancer negativity information check service via API is ideal for companies, financial institutions, insurance companies, and professionals who need to quickly verify the presence of negative events, such as protests or prejudicial actions, involving freelancers.
The service is available from 9:00 AM to 7:00 PM on weekdays. Requests made outside these hours are queued and processed the next business day.
Openapi manages the entire request process via API in full compliance with current privacy regulations, using data minimization and encryption methods.For more information, please refer to the Privacy documentation on our website.
The produced documents are deleted from Openapi systems according to the timelines visible in the Redemption Period (the time limit after which the document is deleted from our servers) within the privacy documentation. If necessary, the customer can contact the authorized Professional who provided the service, who is required to keep a copy as per regulations.
The service is delivered within two working hours.
The cost per request is €0.70.