€0.70 + VAT
Obtain the name, residence, registered office, code and ATECO description, phone number, and negative events of a freelancer using only the VAT number.
The Check Risk for Freelancers (All) service belongs to the RISK API and allows you to obtain, from the parameter tax code, a series of useful information for identifying residence, fiscal domicile, and telephone number, as well as verifying any negative events related to a freelancer.
The service is identified by the endpoint https://risk.openapi.com/IT-request.
Check Risk for Freelancers (All) allows you to retrieve in a single request the name, registered office, ATECO code and description, negative events, and phone number.
POST/request
The method to be used in the request is POST:
POSThttps://risk.openapi.com/IT-request
The parameters to be passed in the body of the call are:
This is an example of the parameters to use for a request with the tax code RSSMRA90D15L117D:
{
"cf_piva": "RSSCLD79R07H501O",
"tipo": [
"anagrafica", "negativita","telefoni"
]
"callback": {
"url": "https://yourdomain.com/your_script",
"method": "POST",
"field": "data",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}
}
It is also possible to request only a part of the information. In this case, you can indicate the desired dataset (anagrafica, negativita, or telefoni) in the "tipo" field or directly use the specific endpoints for each dataset in the request.
The response is asynchronous, and you can set a callback during the request to be notified when the data is available, without needing to repeatedly call the GET/request/{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 the user wants to include in the callback (such as session_id).
POST/request
The response will contain the request ID, which can be used in a subsequent call to access the desired data:
{
"data": {
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "RSSMRA90D15L117D",
"tipo": [
"anagrafica",
"negativita",
"telefoni"
],
"callback": true,
"url" https://yourdomain.com/your_script,
"field" data,
"method" POST,
"data": false,
"headers": {
"session_id": ""oiwejdf89453urf945jfg""
}
"esito": "null"
"timestamp": "null"
"owner": "test@openapi.com"
"soggetto": "null"
"status": "PENDING",
"date_request": "null",
"date_completion": "null",
},
"success": true,
"message": "",
"error": null
}
GET/IT-request/{id}
To retrieve the data, a second request must be made to another endpoint with the previously obtained ID:
POST https://risk.openapi.com/IT-request/60e866b6b3178c6dc80adf8e
GET/IT-request/{id}
The response will contain the following information:
{
"data": {
"status": "COMPLETED",
"date_request": "2021-04-09 17:09:42",
"date_completion": "2021-04-09 17:40:57",
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "RSSCLD79R07H501O ",
"tipo": [
"anagrafica"
],
"callback":"false",
"esito": {
"codice": 200,
"info": "OK"
}
"timestamp": 1625232029,
"owner": "impresa@openapi.it",
"soggetto": {
"code": "RSSCLD79R07H501O ",
"risultato": "OK",
"nome": Claudio,
"cognome": Rossi,
"deceduto": false,
"decesso_data": null,
"nascita_luogo": ROME,
"data_luogo": 1970-10-01,
"sesso": M,
"residenza": {
"indirizzo": "VIA OSTIENSE 11",
"toponimo": "VIA,
"via": "OSTIENSE",
"numero_civico": "11",
"comune": "ROME",
"cap": "00127",
"provincia": "RM"
},
"domicilio_fiscale": {
"indirizzo": "VIA OSTIENSE 11",
"toponimo": "VIA,
"via": "OSTIENSE",
"numero_civico": "11",
"comune": "ROME",
"cap": "00127",
"provincia": "RM"
},
"denominazione": "ROSSI CLAUDIO",
"partita_iva": "12485671007",
"ateco_codice": "461901",
"ateco_descrizione": "Agents and representatives of various products without predominance of any"
"sede_legale": {
"indirizzo": "VIALE F TOMMASO MARINETTI 221",
"toponimo": "VIALE",
"via": "F TOMMASO MARINETTI",
"numero_civico": "221",
"comune": "ROME",
"cap": "00143",
"provincia": "RM"
}
"utenze":[
"061234567"
],
"negativita": {
"protests": false,
"prejudicials": false,
"procedures": false
}
}
},
"success": true,
"message": "",
"error": null
}
CONDITIONS AND USAGE OF THE SERVICE
Although the service is available automatically via API, it is subject to continuous monitoring of LOGs due to regulatory requirements, with the following limitations:
Requests made outside of these hours or days are queued and processed with priority on the next business day.
As per the contractual conditions, the service has daily rate limit restrictions to ensure proper service management.
If you would like a personalized 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!
Through a quick check, it allows assessment of the financial reliability of the professional. This tool is useful for companies, financial institutions, and business partners who need to quickly verify the economic stability of freelancers before initiating collaborations.
With the Check Freelancers service, you can obtain the following information:
It is possible to obtain data in structured formats such as JSON or XML, which are particularly useful for automatic integration into computer systems or for data processing through specific software.
The Check Freelancers is designed for various categories of users who need to assess the risk and financial stability of freelance professionals, including:
Information is provided via API within 2 hours. This timeframe ensures the rapid availability of requested data, allowing users to efficiently integrate the information into their systems.
Requests are processed exclusively on business days, from 9:00 AM to 7:00 PM. Those submitted outside these hours or during holidays will be queued and handled with priority on the next business day.
The cost of the Check Freelancers for each individual request via recharge is €2.20 + VAT.