The "Personal data" service is part of the API RISK and allows you to obtain a series of useful information for verifying, identifying, and confirming the existence of a person, starting from the parameter tax code.

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 included in the body of the request are:

• Tax Code
• Callback (optional)

This is an example of the parameters needed for a request with the 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 /richiesta/{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 /anagrafica

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

{
    "data": {
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "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-richiesta/{id}

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

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

EXAMPLE RESPONSE GET /IT-richiesta/{id}

The response will provide access to the following information:

• Name and surname
• Residence
• Gender
• Place and Date of Birth
• Living status
• possible date of death

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2021-07-09 17:09:42",
      "date_completion": "2021-07-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "RSSMRA90D15L117D",
      "tipo": [
        "anagrafica"
      ],
      "callback": false,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1625232029,
      "owner": "[email protected]",
      "soggetto": {
        "code": "RSSMRA90D15L117D",
        "code_conferma": "RSSMRA90D15L117D",
        "risultato": "OK",
        "nome": "Claudio",
        "cognome": "De Rossi",
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo": ROMA,       
        "nascita_data": 1970-01-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": null,
        "denominazione": De Rossi Claudio,
        "partita_iva": null,
        "sede_legale": null
        }
    },
    "success": true,
    "message": "",
    "error": null
  }
  

The "Personal Data-Risk" service is also available for searches on Freelance Professionals and Companies.

Similarly, the "Personal Data-Risk" subscription can be used for searches on freelance professionals, companies, individuals.

CONDITIONS AND TERMS OF SERVICE USAGE

The service, although available automatically via API, 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 outside these hours or days go into a queue and are processed with priority on the next working day.

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

In case of exceeding the rate limit provided by the subscription, calls will switch to being charged to the wallet credit.

If you want a personalized service, contact us here.