Our prices
Price list for single API calls
- Risk Freelancer € 2,20 + vat
- Self-employed Data Report € 0,80 + vat
- Self-employed Telephone numbers report € 0,70 + vat
- Self-employed Negative events report € 0,70 + vat
Freelancer Real Time Risk
- Home
- Business Information
- Freelancer Real Time Risk
Delivery :
2 Hours
-
starting from € 0,70 + vat
Get the name, residence, registered office, ATECO code and description, telephone and negative events of a freelancer.
All freelance tracking information available via API in minutes.
The Risk Freelancer service is part of the RISK API and allows, starting from the parameter tax code, to obtain a series of useful information for identifying the residence, phone number, and verifying any negative events.
The service is identified by the endpoint https://risk.openapi.com/IT-request.
The Risk Freelancer service allows with a single request to obtain the name, registered office, ATECO code and description, negative events, and phone number.
EXAMPLE POST REQUEST /request
The method to use in the request is POST:
POST https://risk.openapi.com/IT-richiesta
The parameters to pass in the body of the call are:
- tax code
- callback (optional)
This is an example of the parameters needed for a request with tax code 12485671007:
{
"cf_piva": "RSSCLD79R07H501O",
"tipo": [
"anagrafica", "negativita","telefoni"
]
"callback": {
"url": "https://yourdomain.com/your_script",
"method": "POST",
"field": "data",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}
}
It is possible to request only a part of the information. In this case, it will be possible to specify in the type field the desired dataset of information (company profile, negativity, or phone numbers) or to use the specific endpoints for each dataset directly during the request phase.
The response is asynchronous. It is possible to set up a callback during the request phase to be updated when the data is available without having to call the GET /request/{id} endpoint multiple times to check its status. If the callback is set, the 'headers' field is mandatory 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 /request
The response will contain the request id to be used in a second call to obtain 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": "[email protected]"
"soggetto": "null"
"status": "PENDING",
"date_request": "null",
"date_completion": "null",
},
"success": true,
"message": "",
"error": null
}
EXAMPLE REQUEST GET /IT-request/{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-request/{id}
The response will provide access to the following information:
- First and Last Name
- VAT Number
- Company Name
- VAT Number
- Tax Code
- Residential Address
- Fiscal Domicile Address
- Registered Office Address
- ATECO Code and Description
- Date and place of birth
- Gender
- Phone Number (landline or mobile)
- Presence of negative events (protests, prejudicial records, insolvency proceedings)
{
"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": "[email protected]",
"soggetto": {
"code": "RSSCLD79R07H501O ",
"risultato": "OK",
"nome": Claudio,
"cognome": Rossi,
"deceduto": false,
"decesso_data": null,
"nascita_luogo": ROMA,
"data_luogo": 1970-10-01,
"sesso": M,
"residenza": {
"indirizzo": "VIA OSTIENSE 11",
"toponimo": "VIA,
"via": "OSTIENSE",
"numero_civico": "11",
"comune": "ROMA",
"cap": "00127",
"provincia": "RM"
},
"domicilio_fiscale": {
"indirizzo": "VIA OSTIENSE 11",
"toponimo": "VIA,
"via": "OSTIENSE",
"numero_civico": "11",
"comune": "ROMA",
"cap": "00127",
"provincia": "RM"
},
"denominazione": "ROSSI CALUDIO",
"partita_iva": "12485671007",
"ateco_codice": "461901",
"ateco_descrizione": "Agenti e rappresentanti di vari prodotti senza prevalenza di alcuno"
"sede_legale": {
"indirizzo": "VIALE F TOMMASO MARINETTI 221",
"toponimo": "VIALE",
"via": "F TOMMASO MARINETTI",
"numero_civico": "221",
"comune": "ROMA",
"cap": "00143",
"provincia": "RM"
}
"utenze":[
"061234567"
],
"negativita": {
"protesti": false,
"pregiudizievoli": false,
"procedure": false
}
}
},
"success": true,
"message": "",
"error": null
}
The Risk Freelancer service is also available for searches on Individuals and Companies.
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 client based on the annual volumes purchased
Requests made at other times or on other days are queued and processed with priority on the next 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.