---
title: "Genera Codice Fiscale"
method: POST
path: "/python/italian/codice-fiscale/generate"
tags: ["Tool"]
---

# Genera Codice Fiscale

`POST /python/italian/codice-fiscale/generate`

## Request

- Base URL: `https://imperioutils.com/api`
- URL: `https://imperioutils.com/api/python/italian/codice-fiscale/generate`
- Auth: API key in header `X-API-Key`

Genera un Codice Fiscale italiano da dati anagrafici (cognome, nome, data di nascita, sesso, e comune/stato estero di nascita — oppure direttamente il codice Belfiore). Restituisce il CF "base" (la variante omocodica in caso di collisione è assegnata dall'Agenzia).

Costo: **0 crediti**. Autenticazione: header `X-API-Key` (una chiave gratuita si ottiene da https://imperioutils.com/signup e si rigenera da https://imperioutils.com/settings/profile).

La stessa operazione è provabile **senza account** su `POST /registry/demo/fisco-it-validator` con `action: "gen"`.

## Request body

- object
  - `cognome` string, required: Cognome.
  - `nome` string, required: Nome.
  - `data_nascita` string, required: Data di nascita in formato GG/MM/AAAA (es. 10/12/1985).
  - `sesso` 'M' | 'F', required: Sesso: M o F.
  - `comune` string: Comune (o stato estero) di nascita. In alternativa usa codice_belfiore.
  - `provincia` string: Sigla provincia (es. PI) per disambiguare comuni omonimi.
  - `codice_belfiore` string: Codice catastale/Belfiore del luogo di nascita (alternativa precisa al comune).

## Response `200`

Il JSON dello strumento, restituito così com'è.

## Other responses

- `401`: Nessuna credenziale o chiave rifiutata. Il corpo porta `details.header`, `details.docs` e `details.get_key`.
- `402`: Crediti esauriti.
- `429`: Tetto di richieste al minuto del piano superato.

---

[API](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane.md) · [All operations](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane/llms.txt) · [OpenAPI document](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane/revisions/4b7a05d52f6c?raw)