Anagrafica Persona

Il servizio Anagrafica Persona appartiene all'API RISK e dal parametro codice fiscale consente di ottenere una serie di informazioni utili alla verifica, all'individuazione e dell'accertamento dell'esistenza in vita di una persona.

Anagrafica Persona consente di accedere alle seguenti informazioni del soggetto:

Il servizio è identificato dall'endpoint https://risk.openapi.com/IT-anagrafica.

ESEMPIO RICHIESTA

POST/IT-anagrafica

Il metodo da utilizzare nella richiesta è POST/IT-anagrafica

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

I parametri da passare nel body della chiamata sono:

Questo è un esempio dei parametri necessari per una richiesta con codice fiscale RSSMRA90D15L117D:

{
  "cf_piva": "RSSMRA90D15L117D",  
  "callback": {
    "url": "https://yourdomain.com/your_script",
    "field": "data",
    "method": "POST",
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }
}

La risposta è asincrona. È possibile impostare, in fase di richiesta, anche una callback per essere aggiornati su quando i dati saranno disponibili, senza dover chiamare più volte l'endpoint GET/richiesta/{id} per verificarne lo stato. In caso venga impostata la callback, 'headers' è un campo obbligatorio e può essere utilizzato per dichiarare tutti gli headers che l'utente vorrebbe venissero indicati nella callback (come ad esempio session_id).

ESEMPIO RISPOSTA

POST/IT-anagrafica

Nella risposta sarà disponibile l'id della richiesta, da utilizzare in una seconda chiamata per poter accedere ai dati desiderati:

{
    "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": "test@openapi.com"
      "soggetto": "null"
      "status": "PENDING",
      "date_request": "null",
      "date_completion": "null",
      },
    "success": true,
    "message": "",
    "error": null
  }

ESEMPIO RICHIESTA

GET/IT-richiesta/{id}

Per ottenere i dati sarà necessario effettuare una seconda richiesta, come anticipato, ad un altro endpoint con l'ID precedentemente ottenuto.

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

ESEMPIO RISPOSTA

GET/IT-richiesta/{id}

Nella risposta sono presenti le informazioni sul soggetto: Nome e Cognome, Indirizzo residenza, Data e luogo di nascita, Sesso, Stato in vita ed eventuale data di morte.

{
    "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": "test@openapi.it",
      "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
  }
  

Il servizio è ideale per imprese che necessitano di verificare e ottenere rapidamente informazioni aggiornate su un privato. Alcune tipologie di aziende che hanno già integrato l'API sono agenzie di recupero crediti, agenzie investigative, istituti bancari e assicurativi, notai e avvocati.

Il servizio di Risk Anagrafica è disponibile anche per ricerche su Liberi Professionisti e su Aziende.

Allo stesso modo, l'abbonamento Risk Anagrafico può essere utilizzato per ricerche su liberi professionisti, aziende, privati.

CONDIZIONI E MODALITÀ DI UTILIZZO DEL SERVIZIO

Il servizio, nonostante sia disponibile in modalità automatica tramite API, per motivi di normativa è sottoposto a monitoraggio continuo dei LOG con le seguenti limitazioni:

Le richieste effettuate in altri orari o giorni vanno in coda e sono lavorate in modalità prioritaria il primo giorno lavorativo.

Il servizio, come da condizioni contrattuali, ha vincoli di rate limite giornalieri impostati per una corretta gestione del servizio.
Questi limiti variano in funzione dell'abbonamento:

In caso di superamento del rate limit previsto dall'abbonamento, le chiamate passeranno ad addebito su credito del borsellino.

Se desideri avere un servizio personalizzato contattaci qui.