The Risk Persona service belongs to the RISK API and allows, starting from the parameter tax code, to obtain a series of useful information for the verification and identification of an individual.

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

The Risk Persona service allows with a single request to obtain first and last name, residence, negative records, and phone number.

EXAMPLE POST REQUEST /request

The method to be used in the request is POST:

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

The parameters to be passed in the body of the call are:

• tax code
• callback (optional)

This is an example of the parameters required for a request with tax code DRSCLD70P15H501V:

{
  "cf_piva": "DRSCLD70P15H501V",  
  "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 part of the information. In this case, it will be possible to indicate in the type field the desired dataset of information (registry information, negativity, or phone numbers) or to use directly the specific endpoints for each dataset during the request.

The response is asynchronous. It is possible to set up a callback during the request to be updated on when the data will be 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 include the id of the request to use in a second call to obtain the desired data.

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

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

EXAMPLE RESPONSE GET /IT-request/{id}

In the response, it will be possible to access the following information:

• First Name
• Last Name
• Life Status
• Possible Date of Death
• Place and Date of Birth
• Gender
• Residential Address
• Phone Number (landline or mobile)
• Presence of Negative Events (protests, prejudicial actions, bankruptcy procedures)

{
    "data": {
      "status": "COMPLETED",
      "date_request": "2024-03-09 17:09:42",
      "date_completion": "2024-03-09 17:40:57",
      "id": "60e866b6b3178c6dc80adf8e",
      "cf_piva": "DRSCLD70P15H501V",
      "tipo": [
        "anagrafica",
        "negativita",
        "telefoni"
      ],
      "callback": null,
      "esito": {
        "codice": 200,
        "info": "OK"
      },
      
      "timestamp": 1717141431,
      "owner": "[email protected]",
      "soggetto": {
        "code": "DRSCLD70P15H501V",
        "risultato": "OK",
        "nome": CLAUDIO,
        "cognome": DE ROSSI,
        "deceduto": false,
        "decesso_data": null,
        "nascita_luogo": ROMA,       
        "nascita_data": 1970-01-15,       
        "sesso": M,       
        "residenza":{
          "indirizzo": "VIA OSTIENSE, 22 ",
          "toponimo": "VIA",
          "via": "OSTIENSE",
          "numero_civico": "221",
          "comune": "ROMA",
          "cap": "00153",
          "provincia": "RM"
        },
        "domicilio_fiscale": null,
        "denominazione": CLAUDIO DE ROSSI,
        "partita_iva": null,
        "sede_legale": null
        "utenze":[
          "061234567",
          "061234568",
          "333123456"
        ],
        "negativita": {
          false,
          false,
          false
        }
      }
    },
    "success": true,
    "message": "",
    "error": null
  }
  

The Risk Persona service is also available for searches on Companies and Freelancers.

CONDITIONS AND TERMS OF SERVICE USE

The service, although available automatically via API, is subject to continuous LOG monitoring for 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 customer based on the annual volumes purchased

Requests made at other times or days are queued and processed as a 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.