Data on freelancers

  • Openapi Evasione : 2 Hours
  • Openapi starting from € 0,015 + vat

Get data on freelancers such as name, residence, registered office, activity from the tax code.

More than 25 Freelancer information available via API

Esempio Data on freelancers

The Freelancer Registry service belongs to the RISK API and allows, starting from the parameter fiscal code, to obtain a series of information useful for verifying, identifying, and accessing information about a Freelancer's activity.

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

EXAMPLE REQUEST POST /anagrafica

The method to be used in the request is POST:

POST https://risk.openapi.com/IT-anagrafica


The parameters to be passed in the request body are:

  • fiscal code
  • callback (optional)

This is an example of the parameters required for a request with fiscal code RSSMRA90D15L117D:

{
  "cf_piva": "RSSMRA90D15L117D",  
  "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 call the GET /request/{id} endpoint multiple times to check its status. If a 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 /anagrafica

The response will include the ID of the request to be used in a second call to obtain the desired data.

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "DRSCLD70P15H501V",
      "tipo": [
        "anagrafica"
      ],
      "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 anticipated, to another endpoint with the ID previously obtained.

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


EXAMPLE RESPONSE GET /IT-request/{id}

The response will provide access to the following information:

  • Name and surname
  • Date of birth
  • Place of birth
  • Gender
  • Residence
  • registered office address
  • Possible date of death
  • Company Name
  • VAT number
  • ATECO code and description
{
    "data": {
      "status": "COMPLETED",
      "date_request": "2021-07-09 17:09:42",
      "date_completion": "2021-07-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "DRSCLD70P15H501V",
      "tipo": [
        "anagrafica"
      ],
      "callback": false,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1625232029,
      "owner": "[email protected]",
      "soggetto": {
        "code": "12485671007",
        "code_conferma": "DRSCLD70P15H501V",
        "risultato": "OK",
        "nome": "Claudio",
        "cognome": "De Rossi",
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo":  "ROMA (RM)",
        "nascita_data": "1970-10-15",
        "sesso": "M",
        "residenza": {
          "indirizzo": "VIALE XXI APRILE 221",
          "toponimo": "VIALE",
          "via": "XXI APRILE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00161",
          "provincia": "RM"
        },
        "domicilio fiscale": {
          "indirizzo": "VIALE XXI APRILE 221",
          "toponimo": "VIALE",
          "via": "XXI APRILE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00161",
          "provincia": "RM"
        },
        "denominazione": De Rossi Claudio,
        "partita_iva": 12485671007,
        "ateco_codice": 620100,
        "ateco_descrizione": "Attività degli studi legali",
        "sede_legale": {
          "indirizzo": "VIALE XXI APRILE 221",
          "toponimo": "VIALE",
          "via": "XXI APRILE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00161",
          "provincia": "RM"
        }
      }
    },
    "success": true,
    "message": "",
    "error": null
  }
  


The Risk Anagrafica service is also available for searches on Individuals and Companies.

Similarly, the Risk Anagrafico subscription can be used for searches on individuals, companies, private entities.

TERMS AND CONDITIONS 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 per individual client based on the annual volumes purchased

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

As per the contractual conditions, the service has daily rate limit constraints set for proper service management.
These limits vary depending on the subscription:

SUBCRIPTION TYPE RATE LIMIT
100.000 per year 2000 per day
50.000 per year 1000 per day
30.000 per year 600 per day
10.000 per year 300 per day
5.000 per year 200 per day
5.000 per month 600 per day
1.000 per month 200 per day
300 per month 100 per day
100 per month 40 per day


If the subscription rate limit is exceeded, calls will be charged to the wallet credit.

If you desire a personalized service, contact us here.

Our prices

Price list for single API calls

Subscribe and save

  • RISK ANAGRAFICO
  • 100 API calls/month (pay monthly) € 0,65 + vat
  • 100 API calls/month (pay annually) € 0,52 + vat
  • 300 API calls/month (pay monthly) € 0,60 + vat
  • 300 API calls/month (pay annually) € 0,48 + vat
  • 1.000 API calls/month (pay monthly) € 0,55 + vat
  • 1.000 API calls/month (pay annually) € 0,44 + vat
  • 5.000 API calls/month (pay monthly) € 0,50 + vat
  • 5.000 API calls/month (pay annually) € 0,40 + vat
  • 10.000 API calls/year (pay annually) € 0,55 + vat
  • 30.000 API calls/year (pay annually) € 0,50 + vat
  • 50.000 API calls/year (pay annually) € 0,45 + vat
  • 100.000 API calls/year (pay annually) € 0,40 + vat