HomeProdottiVerifica Codice Fiscale - Italia

Verifica Codice Fiscale - Italia

Da: €0.0081 + IVA

Il servizio per verificare il codice fiscale di qualsiasi soggetto privato e sapere se effettivamente registrato presso l'Agenzia delle Entrate, tutto tramite API

Evasione

In pochi secondi

API

Risk

Disponibile in
  • it

Il servizio di Verifica Codice Fiscale consente di accertare la validità di un codice fiscale di un privato ed è attualmente disponibile solo per l'Italia.

Il codice fiscale è lo strumento che permette di identificare in modo univoco i cittadini italiani ed è fondamentale per registrare e monitorare le persone e le loro transazioni con enti pubblici e privati. Assegnato dall'Agenzia delle Entrate (l'agenzia fiscale italiana), il codice è simile al numero di sicurezza sociale usato in altri paesi.

L'API Verifica Codice Fiscale è disponibile in due modalità:

  • Modalità asincrona, con elaborazione in background e recupero del risultato tramite ID
  • Modalità sincrona, con risposta immediata nella stessa chiamata

Il codice fiscale è composto da 16 caratteri alfanumerici:

  • 6 caratteri per il cognome e il nome
  • 8 caratteri per la data e il luogo di nascita
  • 2 caratteri di controllo finali

La verifica del codice è essenziale per garantire che questo corrisponda effettivamente a una persona esistente e registrata nel sistema fiscale italiano. Questo strumento aiuta a prevenire frodi e abusi, assicurando che il codice sia valido e appartenga alla persona indicata.

A differenza di altre API, il servizio Openapi non controlla semplicemente la correttezza formale del codice fiscale inserito, ma verifica anche che sia effettivamente presente presso l'Agenzia delle Entrate.

Integrando questo servizio API sarà possibile verificare l'identità di clienti e fornitori, assicurando che le transazioni commerciali avvengano con soggetti legittimi e registrati.

MODALITÀ ASINCRONA

La modalità asincrona rappresenta la soluzione più potente, scalabile ed efficiente per l’integrazione del servizio di Verifica Codice Fiscale. È progettata per la gestione di richieste massive, flussi automatizzati e architetture enterprise ad alto volume.

Grazie alle nuove tecnologie implementate, l’endpoint asincrono consente un risparmio del 10% sui consumi ed è disponibile senza alcun Rate Limit (Zero Rate Limit), garantendo massima continuità operativa anche in caso di picchi di traffico.

Con questa modalità la richiesta viene presa in carico immediatamente e viene restituito un identificativo univoco (ID richiesta). L’elaborazione avviene in background e il risultato potrà essere recuperato successivamente tramite l’endpoint dedicato.

È inoltre possibile configurare un webhook (callback) per essere avvisati automaticamente sugli aggiornamenti di stato della richiesta. La callback non restituisce il risultato della verifica, ma notifica esclusivamente il cambio di stato. Quando lo stato diventa evaso, sarà necessario effettuare una chiamata all’endpoint di recupero per ottenere il risultato definitivo.

ESEMPIO RICHIESTA

POST /IT-verifica_cf

Nel body della richiesta è necessario indicare il codice fiscale da verificare. È inoltre possibile specificare un URL di webhook (callback) per ricevere aggiornamenti di stato.

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

{
  "codice_fiscale": "RSSMRA85M01H501Z",
  "callback": "https://tuodominio.it/webhook"
}

ESEMPIO RISPOSTA INIZIALE

Alla creazione della richiesta il sistema restituisce immediatamente un ID e lo stato di elaborazione.

{
  "id": "abc123",
  "stato": "in_attesa",
  "codice_fiscale": "RSSMRA85M01H501Z",
  "validita": null
}

Lo stato può assumere due valori:

  • in_attesa – la richiesta è in fase di elaborazione
  • evaso – il risultato è disponibile

RECUPERO DEL RISULTATO

Il risultato può essere recuperato interrogando l’endpoint con l’ID ricevuto in fase di creazione.

GET /IT-verifica_cf/{id}

{
  "id": "abc123",
  "stato": "evaso",
  "codice_fiscale": "RSSMRA85M01H501Z",
  "validita": true
}

MODALITÀ SINCRONA

Con questa modalità la verifica del codice fiscale avviene in tempo reale e il risultato viene restituito immediatamente nella stessa chiamata API.

Nel caso in cui il sistema non possa gestire immediatamente la richiesta, non verrà restituito un errore ma uno stato 201 con un ID identificativo. Sarà quindi possibile recuperare successivamente il risultato tramite l’endpoint dedicato.

ESEMPIO RICHIESTA

GET /IT-verifica_cf/{codice_fiscale}

Il parametro da utilizzare è il codice fiscale che si vuole verificare; la richiesta deve essere effettuata con metodo GET.

GET https://risk.openapi.com/IT-verifica_cf/xxxxxxxxxxxxxx

ESEMPIO RISPOSTA

Se la richiesta viene gestita immediatamente, la risposta indicherà se il codice fiscale verificato è valido (true) o non valido (false).

{
  "data": { 
   "validita": true
  }, 
  "success": true,
  "message": "Richiesta completata",
  "error": null
}

Verifica Codice Fiscale è già utilizzato da aziende, professionisti ed enti che hanno bisogno di verificare l'identità di clienti e fornitori per avere la certezza che le transazioni avvengano con soggetti registrati e legittimi, evitando frodi e abusi.

MODALITÀ D'USO E CONDIZIONI DEL SERVIZIO

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
5.000.000 anno 25.000/giorno
1.000.000 anno 10.000/giorno
500.000 anno 5.000/giorno
150.000 anno 3.000/giorno
75.000 anno 1.500/giorno
10.000 mese 1.200/giorno
5.000 mese 600/giorno
1.000 mese 200/giorno

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

Registrati

Hai bisogno di aiuto?

Non hai trovato la risposta che cercavi?

Compila tutti i campi, ti ricontatteremo al più presto!

Domande frequenti

Tramite il servizio Verifica Codice Fiscale è possibile innanzitutto accertare via API la validità di un codice fiscale di un privato in tempo reale. Inoltre,a differenza di altre API, il service permette anche di effettuare una verifica dell’effettiva presenza del codice fiscale presso l'Agenzia delle Entrate italiana.

Che cos'è il servizio di Verifica Codice Fiscale?

Il servizio fa parte di Risk, l’API che permette con una sola richiesta di accedere a numerose banche dati (es. Anagrafe, Agenzia delle Entrate, CCIAA, CRIF, Experian) e a più di 15 report e indagini diversi su privati, liberi professionisti ed imprese.
Queste alcune delle informazioni disponibili via API:

  • Dati sui finanziamenti (CRIF e Experian)
  • Residenza e Domicilio
  • Posto di Lavoro
  • Immobili
  • Telefono
  • Negatività
  • Indicatori di (Credit Score) e recuperabilità
  • Stato Civile e Coniuge
  • Affidabilità
  • Cariche
  • Partecipazioni
  • Data di morte
  • Informazioni su Eredi
  • Rapporti Bancari
  • Trascrizioni
Di quale API fa parte il servizio?

La modalità sincrona restituisce il risultato della verifica del codice fiscale immediatamente nella stessa chiamata API. È ideale per controlli in tempo reale, ad esempio durante la compilazione di un form online.

La modalità asincrona, invece, prende in carico la richiesta e restituisce un ID identificativo; l’elaborazione avviene in background e il risultato può essere recuperato successivamente tramite una seconda chiamata API oppure ricevuto automaticamente tramite callback. È consigliata per gestire elevati volumi di richieste o flussi automatizzati che non richiedono una risposta immediata.

Qual è la differenza tra modalità sincrona e asincrona?

La verifica aiuta a prevenire frodi, abusi e errori e garantisce che le transazioni commerciali e amministrative avvengano con soggetti legittimi e registrati.

Perché è importante verificare un codice fiscale?

No, attualmente il servizio di verifica è disponibile solo per codici fiscali italiani.

È possibile utilizzare il servizio fuori dall'Italia?

Sì. European Vat, che verifica in tempo reale se il VAT di un'azienda è registrato ed opera in Unione Europea, e Company Start, che offre con una sola richiesta API ed in tempo reale oltre 20 dati su imprese italiane (tra cui il codice fiscale di un’azienda).

Esistono servizi su Openapi dedicati alla verifica del Codice Fiscale di un’azienda?

Il servizio è utile ad aziende, professionisti e enti che necessitano di verificare l'identità di clienti e fornitori per assicurarsi che le transazioni avvengano con soggetti registrati e legittimi e che non si verifichino frodi e abusi, assicurando che il codice sia valido e appartenga alla persona indicata.

Per chi è pensato il servizio Verifica Codice Fiscale?

Openapi gestisce l'intero processo di richiesta via API nel pieno rispetto della normativa vigente in materia di privacy, con logiche di minimizzazione e cifrature dei dati. Per maggiori informazioni in merito è possibile consultare la documentazione Privacy all’interno del nostro sito.

Come viene gestita la questione privacy?

Sì, Openapi mette a disposizione servizi dedicati alla verifica e consultazione dei dati aziendali attraverso le soluzioni Company Worldwide, Company Start, Company Advanced e Company TOP.

Questi servizi consentono di accedere a informazioni ufficiali su aziende a livello globale, incluse tutte le realtà europee, permettendo di verificare dati societari, identificativi fiscali e informazioni anagrafiche in modo affidabile e aggiornato.

Le diverse soluzioni sono pensate per rispondere a esigenze differenti, dalla consultazione essenziale fino all’accesso a dati aziendali più completi e strutturati, ideali per attività di verifica, compliance e due diligence.

Esistono servizi su Openapi dedicati alla verifica del Codice Fiscale di un’azienda?

I documenti prodotti vengono cancellati dai sistemi Openapi in base alle tempistiche visibili nel Redemption Period (il tempo limite oltre il quale il documento viene cancellato dai nostri server) all'interno della documentazione privacy. In caso di necessità il cliente può rivolgersi direttamente al Professionista abilitato che ha erogato il servizio che è tenuto a tenere copia secondo normativa.

Dopo quanto tempo Openapi elimina dai suoi sistemi i documenti prodotti?

I tempi di evasione dipendono dalla modalità di integrazione scelta.

Con la modalità sincrona, la verifica viene normalmente elaborata in tempo reale e il risultato è restituito immediatamente nella stessa chiamata API.

Con la modalità asincrona, la richiesta viene presa in carico immediatamente e processata in background. Il risultato è disponibile non appena lo stato diventa evaso e può essere recuperato tramite l’endpoint dedicato (eventualmente previa notifica webhook).

Quali sono i tempo di evasione del servizio?

Il costo per singola richiesta varia in base alla modalità utilizzata.

In modalità sincrona il costo per singola richiesta è di €0,05 + IVA.
In modalità asincrona il costo per singola richiesta è di €0,045 + IVA.

Per questo servizio sono disponibili anche piani in abbonamento, che permettono di ridurre il costo unitario per chiamata in base al volume mensile scelto (con pagamento mensile o annuale).

Il costo in abbonamento parte da €0,04 + IVA a chiamata e può ridursi fino a €0,02 + IVA in base al piano attivato.

QUALI SONO I COSTI DEL SERVIZIO VERIFICA CODICE FISCALE?