Codice Fiscale Subito

Compute the Italian codice fiscale (tax code) of a person from surname, name, sex, birth date and birth place, with the D.M. 23/12/1976 rules. The place can be a comune ('Roma', 'Castro (LE)'), a foreign state ('Francia') or a codice catastale ('H501'); the code valid on the birth date is used. Returns the 16 characters and why each group has its value. The Agenzia delle Entrate may assign an omocodic variant: only it confirms a code.

{
  "type": "object",
  "properties": {
    "surname": {
      "type": "string",
      "description": "Surname (cognome), as on the document.",
      "example": "Rossi"
    },
    "name": {
      "type": "string",
      "description": "Given name(s) (nome), all of them.",
      "example": "Mario"
    },
    "sex": {
      "type": "string",
      "description": "M or F.",
      "enum": [
        "M",
        "F"
      ],
      "example": "M"
    },
    "birth_date": {
      "type": "string",
      "description": "Birth date, YYYY-MM-DD (DD/MM/YYYY accepted).",
      "example": "1985-12-10"
    },
    "birth_place": {
      "type": "string",
      "description": "Comune (with province if ambiguous), foreign state, or codice catastale / Z-code.",
      "example": "Roma"
    }
  },
  "required": [
    "surname",
    "name",
    "sex",
    "birth_date",
    "birth_place"
  ],
  "additionalProperties": false
}

Read back a codice fiscale: sex, birth date (one or two possible centuries), birth comune or foreign state valid on that date, the consonant codes of surname and name, and omocodia. The full name cannot be recovered from a code. Fails with the reason when the format or the check character is wrong.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Codice fiscale, 16 characters (spaces and lowercase accepted).",
      "example": "RSSMRA85T10H501O"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

Check that a codice fiscale is well formed, layer by layer: format, check character, a real birth date, a place code valid on that date, and optionally the surname and name letters. It says whether the code is written correctly, not whether the Agenzia delle Entrate has assigned it (only its own service does).

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Codice fiscale, 16 characters (spaces and lowercase accepted).",
      "example": "RSSMRA85T10H501O"
    },
    "surname": {
      "type": "string",
      "description": "Optional surname to match against characters 1-3.",
      "example": "Rossi"
    },
    "name": {
      "type": "string",
      "description": "Optional name to match against characters 4-6.",
      "example": "Mario"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

Search the 15,000 comuni of every era and the foreign states of the ANPR archive by name or by code (codice catastale like H501, Z-code like Z110). Returns up to 20 places with their province and the dates their code was valid. Give a date to keep only the places valid on it.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Name ('Roma', 'Sant Angelo') or code ('H501', 'Z110').",
      "example": "Pola"
    },
    "date": {
      "type": "string",
      "description": "Optional date YYYY-MM-DD: only places valid on that day.",
      "example": "1940-06-02"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}