Check Risk for Individual (All)

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

Risk Persona allows you to obtain with a single request:

• first and last name
• residence
• negative events 
• phone number

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

REQUEST EXAMPLE

POST /richiesta

The method to use in the request is POST:

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

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

This is an example of the parameters required for a request with the 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 a part of the information. In this case, it will be possible to specify the desired dataset in the "tipo" field (anagrafica, negativita, or telefoni) or directly use the specific endpoints for each dataset during the request.

The response is asynchronous, and it is possible to set a callback during the request to be notified when the data is available, without having to repeatedly call the endpoint GET /richiesta/{id} to check its status. If the callback is set, 'headers' is a mandatory field and can be used to declare all the headers that the user would like to be included in the callback (e.g., session_id).

RESPONSE EXAMPLE

POST /richiesta

The response will include the request ID, which can be used in a subsequent call to access 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": "test@openapi.com"
      "soggetto": "null"
      "status": "PENDING",
      "date_request": "null",
      "date_completion": "null",
      },
    "success": true,
    "message": "",
    "error": null
  }

REQUEST EXAMPLE

GET /IT-richiesta/{id}

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

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

RESPONSE EXAMPLE

GET /IT-richiesta/{id}

The response will provide access to the following information:

{
    "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": "test@openapi.it",
      "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 Check Risk Persona (ALL) service is ideal for companies that need to quickly verify an individual and obtain information such as residence, negative records, and phone number in a timely manner. Currently, the API is used by banks and financial institutions, debt collection agencies, and insurance companies.

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

CONDITIONS AND TERMS OF SERVICE USAGE

Although the service is available in automatic mode via API, it is subject to continuous LOG monitoring due to regulatory requirements, with the following limitations:

Requests made outside these hours or on non-business days are queued and prioritized on the next business day.

The service, as per contractual terms, has daily rate limit constraints set for proper service management.

If you would like a customized service, please contact us here.