API codice fiscale
Calcolo, verifica e inverso del codice fiscale in JSON, gratis e senza chiave. Gli stessi calcoli di questo sito, anche come server MCP per gli assistenti IA.
| Endpoint | Cosa fa | Parametri |
|---|---|---|
| GET /api/v1/calcola | Calcola il codice da cognome, nome, sesso, data e luogo | surname, name, sex, birth_date, birth_place |
| GET /api/v1/decodifica | Legge sesso, data e comune da un codice (inverso) | code |
| GET /api/v1/verifica | Controlla formato, carattere di controllo, data, luogo, nome | code, surname (facoltativo), name (facoltativo) |
| GET /api/v1/luoghi | Cerca il codice catastale di un comune o Stato estero | q, date (facoltativo) |
Esempio: calcolo
https://codicefiscalesubito.it/api/v1/calcola?surname=Rossi&name=Mario&sex=M&birth_date=1985-12-10&birth_place=Roma{
"codice_fiscale": "RSSMRA85T10H501O",
"birth_place": {
"code": "H501",
"label": "Roma (RM)",
"valid_to": null
},
"parts": [
{
"label": "Cognome",
"characters": "RSS",
"rule": "Le prime tre consonanti; se non bastano, le vocali, poi X."
},
{
"label": "Nome",
"characters": "MRA",
"rule": "Con 4 o più consonanti: la prima, la terza e la quarta. Altrimenti come il cognome."
},
{
"label": "Anno",
"characters": "85",
"rule": "Le ultime due cifre di 1985."
},
{
"label": "Mese",
"characters": "T",
"rule": "Dicembre è la lettera T."
},
{
"label": "Giorno e sesso",
"characters": "10",
"rule": "Il giorno di nascita, 10. Per un uomo resta così; per una donna si aggiunge 40 (sarebbe 50)."
},
{
"label": "Comune",
"characters": "H501",
"rule": "Il codice catastale di Roma (RM)."
},
{
"label": "Controllo",
"characters": "O",
"rule": "Calcolato dai primi 15 caratteri: verifica che il codice sia scritto bene."
}
],
"source": "D.M. 23 dicembre 1976 n. 13813 (Ministero delle Finanze); places: ANPR, Archivio storico dei comuni",
"docs": "https://codicefiscalesubito.it/"
}Esempio: codice catastale di un comune soppresso
Pola, in Istria, ha il codice G778 fino al 1947: con una data, l'API tiene solo i luoghi validi quel giorno.
https://codicefiscalesubito.it/api/v1/luoghi?q=Pola&date=1940-06-02{
"query": "Pola",
"date": "1940-06-02",
"count": 2,
"places": [
{
"name": "Pola",
"province": "PL",
"foreign_state": false,
"code": "G778",
"valid_from": "1921-01-05",
"valid_to": "1947-09-15",
"label": "Pola (PL)"
},
{
"name": "Polaveno",
"province": "BS",
"foreign_state": false,
"code": "G779",
"valid_from": "1861-03-17",
"valid_to": null,
"label": "Polaveno (BS)"
}
],
"source": "ANPR, Archivio storico dei comuni"
}Server MCP
Indirizzo https://codicefiscalesubito.it/api/mcp, trasporto HTTP (streamable), senza autenticazione. In un file di configurazione MCP:
{
"mcpServers": {
"codicefiscale": {
"type": "http",
"url": "https://codicefiscalesubito.it/api/mcp"
}
}
}Strumenti: compute_codice_fiscale, decode_codice_fiscale, verify_codice_fiscale, lookup_place. Stessi parametri dell'API.
Regole d'uso
| Chiave | Nessuna |
|---|---|
| Limite | 60 richieste al minuto per IP (429 oltre) |
| Metodi | GET con query string, o POST con corpo JSON |
| CORS | Aperto a tutti i domini |
| Errori | 400 con error e message in italiano |
| Specifica | OpenAPI 3.1: https://codicefiscalesubito.it/api/openapi.json |
| Dati personali | Nessun dato salvato: ogni richiesta è calcolata e dimenticata |
Regole del calcolo e fonti: metodo e fonti. Un problema o un'idea? Scrivi a contatto@codicefiscalesubito.it.
Domande frequenti
L'API del codice fiscale è gratuita?
Sì, senza chiave e senza registrazione, con CORS aperto: si può chiamare anche dal browser. Il limite è di 60 richieste al minuto per indirizzo IP; oltre, la risposta è 429. Per migliaia di codici c'è il calcolo massivo da Excel o CSV.
Come si calcola il codice fiscale con una chiamata API?
GET https://codicefiscalesubito.it/api/v1/calcola con surname, name, sex, birth_date e birth_place. Per Rossi Mario, nato a Roma il 10/12/1985, la risposta è RSSMRA85T10H501O, con la regola di ogni gruppo di caratteri.
L'API dice se il codice fiscale esiste davvero?
No: dice se è scritto bene e coerente con data e luogo. Che sia attribuito a una persona lo conferma solo l'Agenzia delle Entrate, con il servizio Verifica codice fiscale o, per enti e aziende, con i suoi servizi riservati.
Come uso il codice fiscale in Claude, ChatGPT o Cursor?
Aggiungi il server MCP https://codicefiscalesubito.it/api/mcp (HTTP, senza autenticazione) nelle impostazioni dei connettori o nel file di configurazione MCP. Gli strumenti sono quattro: calcolo, inverso, verifica e ricerca del codice catastale.
Quali comuni conosce l'API?
15.354 righe dell'archivio storico ANPR: comuni attuali, comuni soppressi con le date di validità, territori ceduti e Stati esteri con i codici Z. Il luogo usato è quello valido alla data di nascita.