API pubblica gratuita

API codice fiscale italiano

Tre endpoint REST per calcolare, verificare e decodificareil codice fiscale italiano, secondo l'algoritmo del D.M. 12/03/1974. Risposta in JSON, CORS aperto, nessuna chiave richiesta per l'uso ragionevole. Per uso intensivo (>1.000 req/giorno) contattaci.

1 · Calcola codice fiscale

Genera il CF partendo dai dati anagrafici e dal codice Belfiore del comune/stato di nascita.

GET  /api/codice-fiscale/calcola?cognome=Rossi&nome=Mario&giorno=15&mese=1&anno=1990&sesso=M&codiceBelfiore=H501
POST /api/codice-fiscale/calcola
Content-Type: application/json
{
  "cognome": "Rossi",
  "nome": "Mario",
  "giorno": 15,
  "mese": 1,
  "anno": 1990,
  "sesso": "M",
  "codiceBelfiore": "H501"
}

Risposta:

{
  "ok": true,
  "codiceFiscale": "RSSMRA90A15H501X",
  "fonte": "calcoli-horeca",
  "algoritmo": "D.M. 12/03/1974"
}

2 · Verifica codice fiscale

Controlla formato, lunghezza, mese valido e carattere di controllo.

GET  /api/codice-fiscale/verifica?cf=RSSMRA90A15H501X
POST /api/codice-fiscale/verifica  { "cf": "RSSMRA90A15H501X" }

Risposta:

{
  "valido": true,
  "dati": {
    "cfNormalizzato": "RSSMRA90A15H501X",
    "controlloValido": true,
    "anno": 1990,
    "mese": 1,
    "giorno": 15,
    "sesso": "M",
    "codiceBelfiore": "H501",
    "contieneOmocodia": false
  }
}

3 · Inverso (decodifica)

Ricostruisce iniziali, data, sesso, comune e segnala eventuale omocodia.

GET  /api/codice-fiscale/inverso?cf=RSSMRA90A15H501X
POST /api/codice-fiscale/inverso  { "cf": "RSSMRA90A15H501X" }

Note importanti

L'API è gratuita, no auth, CORS *. Edge runtime per latenze basse.
L'algoritmo è formalmente corretto ma non sostituisce la verifica anagrafica dell'Agenzia delle Entrate: due persone diverse possono generare lo stesso CF (omocodia). Per uso ufficiale consulta telematici.agenziaentrate.gov.it.
Codici Belfiore: comuni italiani (4 caratteri lettera+3 cifre, es. H501) e stati esteri (prefisso Z, es. Z110 Francia).
I dati inviati alla API non vengono memorizzati né loggati al di fuori delle metriche aggregate di Vercel.

Esempio fetch in JavaScript

const r = await fetch("https://calcoli-horeca.it/api/codice-fiscale/calcola", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    cognome: "Rossi", nome: "Mario",
    giorno: 15, mese: 1, anno: 1990,
    sesso: "M", codiceBelfiore: "H501"
  })
});
const data = await r.json();
console.log(data.codiceFiscale); // "RSSMRA90A15H501X"

Vuoi integrare il calcolatore direttamente nella tua pagina senza chiamare l'API? Usa il nostro widget embed.