Address details for Italy

This page describes only country specific information for the address details response. See get address details documentation for an overview of the address details request and response in general.

Italian address "details" property example

{
    "language": "it-IT",
    "address": {
        "country": "Italy",
        "locality": "Roma",
        "street": "Piazza di Monte Citorio",
        "postcode": "00186",
        "building": "1/A",
        "buildingNumber": 1,
        "buildingNumberAddition": "/A"
    },
    "mailLines": [
        "Piazza di Monte Citorio 1/A",
        "00186 ROMA RM"
    ],
    "location": {
        "latitude": 41.901007,
        "longitude": 12.479481,
        "precision": "Street"
    },
    "isPoBox": false,
    "country": {
        "name": "Italy",
        "iso3Code": "ITA",
        "iso2Code": "IT"
    },
    "details": {
        "itaBuilding": {
            "type": "HouseNumber",
            "number": 1,
            "name": "/A",
            "extension": null,
            "addition": "A",
            "validated": true
        },
        "itaStreet": {
            "name": "Piazza di Monte Citorio",
            "districtName": null,
            "districtRequired": null
        },
        "itaLocality": {
            "id": "58091",
            "name": "Roma",
            "postalName": "ROMA",
            "localName": null
        },
        "itaTerritory": {
            "id": "258",
            "name": "Roma",
            "type": "MetropolitanCity",
            "code": "RM",
            "nuts3": "ITI43"
        },
        "itaRegion": {
            "id": "12",
            "name": "Lazio",
            "nuts2": "ITI4"
        },
        "itaGeographicalDivision": {
            "id": "3",
            "name": "Centro",
            "nuts1": "ITI"
        }
    }
}

Response property "details" for country code "ITA"

itaBuilding: struct

hide children Italy building address details.

type: string

Type of address, one of "HouseNumber", "KilometerNumber", "PoBoxNumber", "NoNumber". (Italian: Numero civico, Chilometrica, Casella Postale, Senza numero civico)

number: int or null

The number for the address, for 'HouseNumber' and 'PoBoxNumber' types.

name: string or null

Formatted name of address that can be directly combined with number. (combination of extension, addition)

extension: string or null

The name of address if not a number, for 'KilometerNumber' and 'NoNumber' types.

addition: string or null

Addition to add to number or name (Italian: altro).

validated: boolean

Indication whether the address could be validated. When true it means that the combination of building number/name and addition exists.

itaStreet: struct

hide children Italy street details.

name: string

Name of the street

districtName: string or null

District the street is in (Italian: Quartiere or Frazione).

districtRequired: boolean or null

True if district is required as a mail line (because the street is not unique in the locality)

itaLocality: struct

hide children Italy municipality details. (Italian: Comune)

id: string

Municipality Istat code, zero-padded 6-digit number (Italian: Codice Comune)

name: string

Municipality name (Italian: Comune (dizione italiana))

postalName: string

Municipality name in postal format (Italian: Comune (postale))

localName: string or null

Municipality name in local language (Italian: Comune (dizione straniera))

itaTerritory: struct

hide children Supra-municipal territory administrative details. (Italian: UTS - Unione Territoriale Sovracomunale)

id: string

Supra municipal territory code (Italian: Codice UTS), which denotes the administrative level which includes provinces.

name: string

Supra municipal territory name (Italian: UTS - Unione Territoriale Sovracomunale).

type: string

Supra municipal territory type, one of "Province", "AutonomousProvince", "MetropolitanCity", "FreeConsortium", "NonAdministrativeUnit" (Italian: Provincia, Provincia autonoma, Città metropolitana, Libero consorzio di comuni, Unità non amministrativa).

code: string

Supra municipal territory two letter code (Italian: Sigla automobilistica).

nuts3: string

NUTS-3 code

itaRegion: struct

hide children Italy region administrative details. (Italian: Regione)

id: string

Region code (Italian: Codice Regione).

name: string

Region name (Italian: Regione).

nuts2: string

NUTS-2 code

itaGeographicalDivision: struct

hide children Italy geographical division administrative details. (Italian: Ripartizione geografica)

id: string

Geographic division code (Italian: Codice Ripartizione geografica).

name: string

Geographic division name (Italian: Ripartizione geografica).

nuts1: string

NUTS-1 code