Da: 0,40 € + IVA
Ottieni oltre 25 dati per l'individuazione di libero professionisti come nominativo, residenza, sede legale, codice e descrizione ATECO, a partire dal codice fiscale.
Il servizio Anagrafica Libero Professionista appartiene all'API RISK e consente, a partire dal parametro codice fiscale, di ottenere una serie di informazioni utili alla verifica, all'individuazione e accedere ad informazioni sull'attività di un Libero Professionista.
Il servizio è identificato dall'endpoint https://risk.openapi.com/IT-anagrafica.
POST/IT-anagrafica
Il metodo da utilizzare nella richiesta è POST :
POST 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 vuole vengano ritornati nella callback (come ad esempio session_id)
POST /IT-anagrafica
Nella risposta sarà disponibile l'id della richiesta da utilizzare in una seconda chiamata per ottenere i dati desiderati
{
"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
}
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.
POST https://risk.openapi.com/IT-richiesta/60e866b6b3178c6dc80adf8e
GET /IT-richiesta/{id}
Nella risposta sarà possibile accedere alle seguenti informazioni:
{
"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
}
CONDIZIONI E MODALITA' DI UTILIZZO DEL SERVIZIO
Il servizio, nonostante sua disponibile in modalità automatica tramite API, per motivi di normativa è sottoposto a monitoraggio continuo dei LOG con le seguenti limitazioni:
- il servizio è attivo dalle 9 alle 19
- il servizio è attivo solo nei giorni feriali
- il rate limit è configurato in automatico per singolo cliente in funzione dei volumi annui acquistati
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:
TIPOLOGIA ABBONAMENTO RATE LIMIT 100.000 anno 2000/giorno 50.000 anno 1000/giorno 30.000 anno 600/giorno 10.000 anno 300/giorno 5.000 anno 200/giorno 5.000 mese 600/giorno 1.000 mese 200/giorno 300 mese 100/giorno 100 mese 40/giorno 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.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
Un servizio che fornisce oltre 25 dati su liberi professionisti, come nominativo, residenza, codice ATECO, e sede legale.
Con il servizio di Anagrafica Libero Professionista è possibile ottenere le seguenti informazioni:
Questi dati, insieme agli altri, offrono una visione del Libero Professionista, evidenziandone le principali caratteristiche.
Il servizio "Anagrafica Libero Professionista" di Openapi è utilizzabile da aziende, enti e professionisti che hanno bisogno di ottenere informazioni ufficiali sui liberi professionisti italiani, come denominazione, partita IVA, e altri dati relativi alla loro attività. Può essere utilizzato per verificare e arricchire le informazioni sui professionisti per finalità di business, controllo o monitoraggio delle attività economiche.
Sono asincrone ed è possibile impostare una callback per sapere quando i dati sono disponibili.
I dati vengono forniti entro circa 2 ore lavorative.
No, è disponibile nei giorni feriali dalle 9 alle 19. Il servizio ha limiti di utilizzo giornalieri basati sul tipo di abbonamento scelto. In caso di superamento dei rate limit previste dall'abbonamento, le chiamate passeranno ad addebito su credito del borsellino.
È possibile optare per abbonamenti che offrono tariffe più convenienti, con prezzi a partire da €0,40 + IVA per richiesta. Gli abbonamenti prevedono limiti di utilizzo, variabili a seconda del tipo di abbonamento scelto, garantendo maggiore flessibilità in base alle esigenze.
In alternativa, il costo per ogni singola richiesta tramite ricarica è di €0,80 + IVA