API per verificare e calcolare il Codice Fiscale

Verifica l'esattezza di un Codice Fiscale o generalo con le API Rest
Utilizza le API di MioCodiceFiscale.com per verificare la correttezza di un codice fiscale italiano. Oltre alla sua verifica, puoi ottenere i dati anagrafici corrispondenti al possessore del codice fiscale verificato.
Grazie alle API pubbliche di MioCodiceFiscale.com potrai calcolare il codice fiscale di una persona. Lo puoi generare in pochi istanti trasmettendo nome, cognome, giorno e comune di nascita e sesso. È possibile, inoltre, richiedere tramite i servizi delle API anche il calcolo di un codice fiscale estero.
Le API di verifica e creazione di un codice fiscale, possono essere integrate facilmente su qualsiasi sito internet, e-commerce o web app.
Nota importante!
Può capitare, in casi eccezionali, che il codice fiscale verificato risulti non valido seppur corretto.
Tramite le API viene analizzata la correttezza della forma di un Codice Fiscale e non che esista realmente e sia quindi associato ad una persona.
Per i casi di omocodia, rari, ma pur sempre presenti, può capitare che il Codice Fiscale generato dalle API non corrisponda a quello reale.
L'Algoritmo delle API, verifica e genera il Codice fiscale in base alle regole del D.M. del 12.3.1974
Privacy e trattamento dei dati
Tutti i dati trasmessi tramite le API non vengono nè tracciati nè registrati, ma solo processati dall'algoritmo.
Avvio rapido delle API di MioCodiceFiscale.com
Questa guida ti fornirà tutto ciò di cui hai bisogno per iniziare a utilizzare le API di MioCodiceFiscale.com per calcolare il codice fiscale, per verificarne la validità e altro ancora. Analizzeremo la generazione della chiave API, la gestione della lingua preferita e la prima chiamata API, una semplice richiesta all'endpoint Ping.
Genera la tua chiave API
Il modo più semplice per autenticare una richiesta alle API di MioCodiceFiscale.com è utilizzare una chiave API.
Ecco come puoi generarne una:
- Clicca sul pulsante Genera Chiave API presente nel menu di questa guida
- Inserisci il dominio del sito internet che effettuerà la chiamata alle API
- Inserisci una email di contatto valida
- Clicca sul pulsante Ricevi Chiave API tramite email
Sarà così generata la tua Chiave API (access_token).
Gestione della lingua
La lingua di default delle risposte delle API di MioCodiceFiscale.com è l'italiano
E' possibile tuttavia, ricevere i messaggi delle risposte API in altre lingue.
Puoi effettuare chiamate alle API di MioCodiceFiscale.com, con il metodo che utilizzi abitualmente per effettuare richieste HTTP.
https://api.miocodicefiscale.com/{lingua}/...
Campo | Descrizione | Valori consentiti |
---|---|---|
{lingua}
Stringa di testo |
Il codice della lingua con cui si vuole gestire le risposte delle chiamate API | Italiano: it Inglese: en Rumeno: ro Arabo: ar Cinese (semplificato): zh Nota: il valore va indicato in minisculo. |
Effettua la tua prima chiamata API (Ping Test)
Per verificare che tutto sia impostato correttamente e che la Chiave API sia funzionante, faremo una semplice richiesta all'endpoint Ping. Il raggiungimento di questo endpoint funge da controllo dello stato del servizio API di MioCodiceFiscale.com; non influirà quindi in alcun modo sul tuo account.
https://api.miocodicefiscale.com/ping?access_token={tua-chiave-API}
Campo | Descrizione | Valori consentiti |
---|---|---|
access_token
Stringa di testo |
La tua chiave API | Nessun vincolo |
Se tutto è stato impostato correttamente e la richiesta di ping è andata a buon fine, la risposta sarà simile alla seguente:
{
"status": true,
"message": "Le chiamate API funzionano correttamente!"
}
Campo | Descrizione | Valori della risposta |
---|---|---|
status | Indica la validità della chiamata all’endepoint PING | Boolean Chiamata valida: true Chiamata non valida: false |
message | Indica il messaggio di risposta della chiamata. In caso di errore, indica la causa di tale stato. | Stringa di testo |
API Reference
Questa guida ti fornirà tutto ciò di cui hai bisogno per iniziare a utilizzare le API di MioCodiceFiscale.com per calcolare il codice fiscale, per verificarne la validità e altro ancora.
Calculate
Con il servizio calculate delle API di MioCodiceFiscale.com è possibile calcolare il codice fiscale partendo dai dati anagrafici di una persona.
https://api.miocodicefiscale.com/calculate?lname={cognome}&fname={nome}&gender={sesso}&city={luogo-di-nascita}&state={codice-provincia}&day={giorno-di-nascita}&month={mese-di-nascita}&year={anno-di-nascita}&omocodia_level={livello-omocodia}&access_token={tua-chiave-API}
Campo | Descrizione | Valori consentiti |
---|---|---|
lname
Stringa di testo |
Il cognome della persona | Nessun vincolo |
fname
Stringa di testo |
Il nome della persona | Nessun vincolo |
gender
Stringa di testo |
Il sesso della persona | Sesso maschile: M Sesso femminile: F |
city
Stringa di testo |
La città di nascita della persona o per i nati all'estero lo stato di nascita | Elenco dei comuni e degli stati. Accettata solo la lingua italiana. Città con la presenza di lettere accentate possono essere inviate sia con l'accento sia senza. Es. compatibili: Aglie, Agliè ed Aglié. Se presenti spazi, possono essere inviate sia con il carattere spazio " " che con il codice "%20" |
state
Stringa di testo opzionale |
La sigla indicante la provincia di nascita della persona | Elenco delle sigle delle province italiane. Per i nati all'estero la sigla accettata è: EE |
day
Stringa numerica |
Il giorno di nascita della persona | Valore numerico da 1 a 31. Lo 0 per i numeri da 1 a 9 può essere omesso. |
month
Stringa numerica |
Il mese di nascita della persona | Valore numerico da 1 a 12. Lo 0 per i numeri da 1 a 9 può essere omesso. |
year
Stringa numerica |
L'anno di nascita della persona | Accettato sia valore numerico indicato con 4 cifre es.: 1982, sia valore numerico di 2 cifre es.: 82, 01, ecc. |
omocodia_level
Stringa numerica opzionale |
Il livello massimo di omocodia da utilizzare per ottenere nuovi Codici Fiscali | Stringa numerica tra 1 e 128 Il livello 1 è rappresentato dal codice fiscale rappresentato in data.cf Se omesso, il servizio restituisce tutte le 128 possibili combinazioni. |
access_token
Stringa di testo |
La tua chiave API | Nessun vincolo |
Se tutto è stato impostato correttamente e la richiesta è andata a buon fine, la risposta sarà simile alla seguente:
{
"status": true,
"message": "Codice fiscale calcolato correttamente",
"data":
{
"cf": "RSSMRA82R05F205T",
"all_cf": {
0: "RSSMRA82R05F205T", //Livello 1
1: "RSSMRA82R05F20RT", //Livello 2
2: "RSSMRA82R05F2L5T", //Livello 3
...
127: "RSSMRAUNRLRFNLRT", //Livello 128
}
}
}
Campo | Descrizione | Valori della risposta |
---|---|---|
status | Indica l’esito del calcolo | Boolean Codice fiscale calcolato: true Codice fiscale non calcolato: false |
message | Indica il messaggio di risposta della chiamata. In caso di errore, indica la causa di tale stato. | Stringa di testo |
data | Indica i dati in risposta dalla chiamata API | Array |
data.cf | Il codice fiscale generato | Stringa di testo |
data.all_cf | Elenco dei possibili Codifici Fiscali ottenuti per evitare omocodie | Array di stringhe di testo |
Reverse
Con il servizio reverse delle API di MioCodiceFiscale.com è possibile verificare che il codice fiscale di una persona sia corretto, inoltre è possibile estrarre i dati anagrafici dal codice fiscale.
https://api.miocodicefiscale.com/reverse?cf={codice-fiscale}&access_token={tua-chiave-API}
Campo | Descrizione | Valori consentiti |
---|---|---|
cf
Stringa di testo |
Il codice fiscale da verificare o da cui estrarre i dati anagrafici | Stringa alfanumerica di lunghezza di 16 caratteri |
access_token
Stringa di testo |
La tua chiave API | Nessun vincolo |
Se tutto è stato impostato correttamente e la richiesta è andata a buon fine, la risposta sarà simile alla seguente:
{
"status": true,
"message": "Codice fiscale valido",
"data":
{
"lname": "RSS",
"fname": "MRA",
"gender": "M",
"city": "Milano",
"city_ext": "Milano",
"state": "MI",
"day": "05",
"month": "10",
"year": "82"
"omocodia": "false"
}
}
Campo | Descrizione | Valori della risposta |
---|---|---|
status | Indica l’esito del calcolo | Boolean Codice fiscale valido: true Codice fiscale non valido: false |
message | Indica il messaggio di risposta della chiamata. In caso di errore, indica la causa di tale stato. | Stringa di testo |
data | Indica i dati in risposta dalla chiamata API | Array |
data.lname | 3 lettere che indicano il cognome della persona | Stringa di testo |
data.fname | 3 lettere che indicano il nome della persona | Stringa di testo |
data.gender | Il sesso della persona | Stringa di testo Sesso maschile: M Sesso femminile: F |
data.city | La città di nascita della persona o per i nati all'estero lo stato di nascita | Stringa di testo |
data.city_ext | La città di nascita della persona o per i nati all'estero lo stato di nascita in lingua alternativa | Stringa di testo |
data.state | La sigla indicante la provincia di nascita della persona o per i nati all'estero la sigla EE | Stringa di testo composta da 2 caratteri |
data.day | Il giorno di nascita della persona | Stringa numerica composta da 2 caratteri Valori da 01 a 31 |
data.month | Il mese di nascita della persona | Stringa numerica composta da 2 caratteri Valori 01 a 12 |
data.year | L'anno di nascita della persona | Stringa numerica composta da 2 caratteri Valori da 00 a 99 |
data.omocodia | Indica se il codice fiscale presenta caratteri di sostituzione per evitare le omocodie | Boolean Codice fiscale omocode: true Codice fiscale non omocode: false |
Reverse: Identificazione dell'errore
Il servizio reverse delle API di MioCodiceFiscale.com individua l'errore nel codice fiscale inviato e nel caso in cui si tratti di una singola parte di esso, la mette in evidenza.
Di seguito viene riportata la risposta ottenuta nel caso in cui il codice realativo all'identificazione della città di nascita sia errato.
{
"status": false,
"message": "I dati inseriti relativi al comune di nascita sono errati.",
"data":
{
"cf_error": "GLSGPP82R05***C98R***R"
}
}
Campo | Descrizione | Valori della risposta |
---|---|---|
data.cf_error | Indica la parte di codice fiscale errata | Stringa di testo La parte errata viene racchiusa da degli asterischi: ***parte-errata*** |
Compare
Con il servizio compare delle API di MioCodiceFiscale.com è possibile verificare la corrispondenza tra dati anagrafici di una persona e il codice fiscale.
https://api.miocodicefiscale.com/compare?cf={codice-fiscale}&lname={cognome}&fname={nome}&gender={sesso}&city={luogo-di-nascita}&state={codice-provincia}&day={giorno-di-nascita}&month={mese-di-nascita}&year={anno-di-nascita}&access_token={tua-chiave-API}
Campo | Descrizione | Valori consentiti |
---|---|---|
cf
Stringa di testo |
Il codice fiscale con cui effettuare il confronto | Stringa alfanumerica di lunghezza di 16 caratteri |
lname
Stringa di testo |
Il cognome della persona | Nessun vincolo |
fname
Stringa di testo |
Il nome della persona | Nessun vincolo |
gender
Stringa di testo |
Il sesso della persona | Sesso maschile: M Sesso femminile: F |
city
Stringa di testo |
La città di nascita della persona o per i nati all'estero lo stato di nascita | Elenco dei comuni e degli stati. Accettata solo la lingua italiana. Città con la presenza di lettere accentate possono essere inviate sia con l'accento sia senza. Es. compatibili: Aglie, Agliè ed Aglié. Se presenti spazi, possono essere inviate sia con il carattere spazio " " che con il codice "%20" |
state
Stringa di testo |
La sigla indicante la provincia di nascita della persona | Elenco delle sigle delle province italiane. Per i nati all'estero la sigla accettata è: EE |
day
Stringa numerica |
Il giorno di nascita della persona | Valore numerico da 1 a 31. Lo 0 per i numeri da 1 a 9 può essere omesso. |
month
Stringa numerica |
Il mese di nascita della persona | Valore numerico da 1 a 12. Lo 0 per i numeri da 1 a 9 può essere omesso. |
year
Stringa numerica |
L'anno di nascita della persona | Accettato sia valore numerico indicato con 4 cifre es.: 1982, sia valore numerico di 2 cifre es.: 82, 01, ecc. |
access_token
Stringa di testo |
La tua chiave API | Nessun vincolo |
Se tutto è stato impostato correttamente e la richiesta è andata a buon fine, la risposta sarà simile alla seguente:
{
"status": true,
"message": "I dati anagrafici corrispondono al codice fiscale",
"data":
{
"lname": true,
"fname": true,
"gender": true,
"city": true,
"city_ext": true,
"state": true,
"day": true,
"month": true,
"year": true
}
}
Campo | Descrizione | Valori della risposta |
---|---|---|
status | Indica l’esito del confronto | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
message | Indica il messaggio di risposta della chiamata. In caso di errore, indica la causa di tale stato. | Stringa di testo |
data.lname | Se richiesto il confronto con il cognome, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
data.fname | Se richiesto il confronto con il nome, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
data.gender | Se richiesto il confronto con il sesso, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
data.city | Se richiesto il confronto con il comune di nascita, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
data.state | Se richiesto il confronto con la provincia di nascita, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
data.day | Se richiesto il confronto con il giorno di nascita, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
data.month | Se richiesto il confronto con il mese di nascita, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
data.year | Se richiesto il confronto con l'anno di nascita, ne indica lo stato | Boolean Confronto avvenuto con successo: true Confronto non avvenuto con successo: false |
Omocodia
Con il servizio omocodia delle API di MioCodiceFiscale.com è possibile ottenere il codice fiscale modificato per omocodia.
Possono verificarsi casi, seppur rari, in cui il codice fiscale di due persone diverse calcolato con l'algoritmo standard sia identico. Questi sono i casi di omocodia.
Grazie a questo servizio è possibile ottenere l'elenco di tutti i codici fiscali generabili per ovviare ai casi di omocodia.
https://api.miocodicefiscale.com/omocodia?cf={codice-fiscale}&level={livello-omocodia}&access_token={tua-chiave-API}
Campo | Descrizione | Valori consentiti |
---|---|---|
cf
Stringa di testo |
Il codice fiscale da cui generare le sostituzioni per evitare casi di omocodia | Stringa alfanumerica di lunghezza di 16 caratteri |
level
Stringa numerica |
Il livello massimo di omocodia da utilizzare per ottenere nuovi Codici Fiscali | Stringa numerica tra 1 e 128 |
access_token
Stringa di testo |
La tua chiave API | Nessun vincolo |
Se tutto è stato impostato correttamente e la richiesta è andata a buon fine, la risposta sarà simile alla seguente:
{
"status": true,
"message": "Codici fiscali calcolati correttamente",
"data":
{
0: "GLSGPP82R05C983M", //Livello 1
1: "GLSGPP82R05C98PM", //Livello 2
2: "GLSGPP82R05C9U3M", //Livello 3
3: "GLSGPP82R05C9UPM", //Livello 4
4: "GLSGPP82R05CV83M", //Livello 5
5: "GLSGPP82R05CV8PM", //Livello 6
...
127: "GLSGPPUNRLRCVUPM" //Livello 128
}
}
Campo | Descrizione | Valori della risposta |
---|---|---|
status | Indica l’esito del calcolo | Boolean Codice fiscale valido: true Codice fiscale non valido: false |
message | Indica il messaggio di risposta della chiamata. In caso di errore, indica la causa di tale stato. | Stringa di testo |
data | Indica i dati in risposta dalla chiamata API | Array |
data.Array() | Elenco dei possibili Codifici Fiscali ottenuti per evitare omocodie | Array di stringhe di testo |
Ping
Con il servizio ping delle API di MioCodiceFiscale.com è possibile verificare che tutto sia impostato correttamente e che la Chiave API sia funzionante.
https://api.miocodicefiscale.com/ping?access_token={tua-chiave-API}
Campo | Descrizione | Valori consentiti |
---|---|---|
access_token
Stringa di testo |
La tua chiave API | Nessun vincolo |
Se tutto è stato impostato correttamente e la richiesta di ping è andata a buon fine, la risposta sarà simile alla seguente:
{
"status": true,
"message": "Le chiamate API funzionano correttamente!"
}
Campo | Descrizione | Valori della risposta |
---|---|---|
status | Indica la validità della chiamata all’endepoint PING | Boolean Chiamata valida: true Chiamata non valida: false |
message | Indica il messaggio di risposta della chiamata. In caso di errore, indica la causa di tale stato. | Stringa di testo |
Profile
Con il servizio profile delle API di MioCodiceFiscale.com è possibile visualizzare i dati dell'account associato alla Chiave API.
https://api.miocodicefiscale.com/profile?access_token={tua-chiave-API}
Campo | Descrizione | Valori consentiti |
---|---|---|
access_token
Stringa di testo |
La tua chiave API | Nessun vincolo |
Se tutto è stato impostato correttamente e la richiesta è andata a buon fine, la risposta sarà simile alla seguente:
{
"status": true,
"message": "Chiamata eseguita correttamente"
"data":
{
"site_url": "https://www.example.com",
"email": "email@example.com",
"register_date": "2022-05-06 09:06:04",
"status": "1",
"max_call": "unlimited",
"total_calls": "157",
"services_calls":
{
"reverse": "150",
"calculate": "6",
"profile": "1"
}
}
}
Campo | Descrizione | Valori della risposta |
---|---|---|
status | Indica la validità della chiamata | Boolean Chiamata valida: true Chiamata non valida: false |
message | Indica il messaggio di risposta della chiamata. In caso di errore, indica la causa di tale stato. | Stringa di testo |
data | Indica i dati in risposta dalla chiamata API | Array |
data.site_url | Il sito internet associato all'account | Stringa di testo |
data.email | L'indirizzo email associato all'account | Stringa di testo |
data.register_date | La data di registrazione dell'account | Data |
data.status | Indica se l'account risulta attivo | Boolean Account attivo: 1 Account non attivo: 0 |
data.max_call | Indica il limite sul numero di chiamate che è possibile effettuare con il singolo account. | Stringa numerica o undefined se non ci sono limiti sul numero di chiamate |
data.total_calls | Indica il numero totale di chiamate effettuate dal singolo account a partire dalla data di registrazione. | Stringa numerica |
data.services_calls | Indica il numero totale di chiamate divese per servizio, effettuate dal singolo account a partire dalla data di registrazione. | Array |
Esempi di utilizzo
Di seguito troverai alcuni esempi per utilizzare le API di MioCodiceFiscale e integrarle nel tuo sito internet, o e-commerce o applicazione web.
php
Esempio di chiamata tramite la funzione php file_get_contents del servizio calculate, per calcolare il codice fiscale di una persona.
$url = "https://api.miocodicefiscale.com/calculate"
."?lname={cognome}"
."&fname={nome}"
."&gender={sesso}"
."&city={luogo-di-nascita}"
."&state={codice-provincia}"
."&day={giorno-di-nascita}"
."&month={mese-di-nascita}"
."&year={anno-di-nascita}"
."&access_token={tua-chiave-API}";
$json = file_get_contents($url);
$response = json_decode($json, true);
var_dump($response['status']);
var_dump($response['message']);
var_dump($response['data']);
jQuery
Esempio di chiamata tramite metodo POST del servizio reverse, per verificare la validità di un codice fiscale ed estrarre i dati anagrafici.
var d = {
cf : '{codice-fiscale-da-verificare}',
access_token : {tua-chiave-API}
};
$.ajax({
type: "POST",
url: "https://api.miocodicefiscale.com/reverse",
data: d,
success: function (response) {
console.log(response.status);
console.log(response.message);
console.log(response.data);
}
});
Nota importante!
Può capitare, in casi eccezionali, che il codice fiscale verificato risulti non valido seppur corretto.
Tramite le API viene analizzata la correttezza della forma di un Codice Fiscale e non che esista realmente e sia quindi associato ad una persona.
Per i casi di omocodia, rari, ma pur sempre presenti, può capitare che il Codice Fiscale generato dalle API non corrisponda a quello reale.
L'Algoritmo delle API, verifica e genera il Codice fiscale in base alle regole del D.M. del 12.3.1974
Privacy e trattamento dei dati
Tutti i dati trasmessi tramite le API non vengono nè tracciati nè registrati, ma solo processati dall'algoritmo.