Data Quality user documentation
home/Address validation/Experian Address Validation/Dataset reference/New Zealand

New Zealand

New Zealand's address system, managed by NZ Post and enriched by LINZ's authoritative datasets, offers high-quality, geocoded address data across the country. It underpins efficient delivery, smart city planning, and trusted customer engagement for businesses and government.

Standard address format

A simple business address might look like the below example.

"address": {
    "address_line_1": "Experian",       // Lines 1-3 contain flexible delivery information
    "address_line_2": "1 Main St",      // like organization, street, PO Box, etc
    "address_line_3": "",
    "locality": "MT EDEN",              // Suburb
    "region": "AUCKLAND",               // Town or city
    "postal_code": "1024",              // Postal code
    "country": "NEW ZEALAND"            // Country name
}

Address datasets

The New Zealand address dataset is built on authoritative data from New Zealand Post, offering a complete and validated view of all postally deliverable addresses across the country. Updated quarterly, this dataset ensures businesses can rely on accurate, standardized address data for customer onboarding, delivery logistics, and regulatory compliance.

Country ISO3 nzl
Dataset identifier nz-address
Data source New Zealand Post. All data, extracts and updates © NZ Post.
Update frequency Quarterly

Industries such as retail, financial services, utilities, and government benefit from NZL by ensuring that customer records are clean, consistent, and aligned with national postal standards. It supports address validation during customer onboarding, helps reduce failed deliveries, and enhances customer trust through accurate correspondence. For businesses managing large customer bases or delivering physical goods and services, NZL provides the foundational data needed to streamline operations and improve service quality.

Include nz-address in the datasets array within your /Search, /Validate or /Lookup request. See an example of a partial /Search request and response structure below.

Request Response 
{
  "country_iso": "nzl",
  "components": {
    "unspecified": [
      "1 main"
    ]
  },
  "datasets": [ "nz-address" ]
}

{
  "result": {
    "more_results_available": boolean,
    "confidence": "string",
    "suggestions": [
      {
        "global_address_key": "string",
        "text": "string",
        "matched": [[integer, integer]],
        "format": "string"
      }
    ]
  }
}

The New Zealand DataFusion dataset extends the reach of NZL by including non-deliverable addresses such as rural properties, private bags, and other physical locations not serviced by New Zealand Post. This broader coverage enables organizations to understand and engage with the full spectrum of residential and commercial properties across the country.

Country ISO3 nzl
Dataset identifier nz-additional-datafusion
Data source New Zealand Post. All data, extracts and updates © NZ Post.
Update frequency Quarterly

Industries like telecommunications, insurance, utilities, and public services use DataFusion to support infrastructure planning, risk assessment, and customer profiling. It allows businesses to identify serviceable locations beyond the postal network, helping them expand coverage, assess market potential, and make informed decisions about resource allocation. Whether you're planning broadband rollout, evaluating property risk, or mapping service zones, DataFusion delivers the depth and flexibility needed to operate confidently across New Zealand's diverse address landscape.

Include nz-additional-datafusion in the datasets array within your /Search, /Validate or /Lookup request. See an example of a partial /Search request and response structure below.

Request Response 
{
  "country_iso": "nzl",
  "components": {
    "unspecified": [
      "1 main"
    ]
  },
  "datasets": [ "nz-additional-datafusion" ]
}

{
  "result": {
    "more_results_available": boolean,
    "confidence": "string",
    "suggestions": [
      {
        "global_address_key": "string",
        "text": "string",
        "matched": [[integer, integer]],
        "format": "string"
      }
    ]
  }
}

Enrichment datasets

The Regional Location Insights Enrichment set enables rooftop-level geocoding for New Zealand addresses with dual coordinate system support. It returns precise geographic coordinates in both latitude/longitude and New Zealand Transverse Mercator (NZTM) formats, providing flexibility for different mapping and geospatial applications. The dataset also includes comprehensive property information, territorial authority, regional council, general and Maori Electorate information.

Dataset identifier nzl_regional_geocodes
Data source New Zealand Post. All data, extracts and updates © NZ Post.
Update frequency Quarterly

This Enrichment set includes indicators of deliverability, precise geographic coordinates for both the center and front of properties, and identifiers for electoral, regional, and territorial boundaries. Each address is linked to authoritative sources such as LINZ parcel IDs and mesh block codes, and classified by property purpose (e.g., residential, business, farm). The dataset also includes match-level metadata to assess geocode accuracy, supporting high-confidence location intelligence for mapping, planning, and service delivery.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the nzl_regional_geocodes Enrichment set below.

Attribute Type Description
addressable string Indicates whether the address is deliverable; values are "Y" or "N".
centroid_of_property_latitude double Latitude of the property's central point.
centroid_of_property_longitude double Longitude of the property's central point.
centroid_of_property_nztm_x_coordinate double Easting (X-axis) value of the property's central point in the NZTM2000 national grid reference system, used for geocoding by Land Information New Zealand (LINZ).
centroid_of_property_nztm_y_coordinate double Northing (Y-axis) value of the property's central point in the NZTM2000 national grid reference system, used for geocoding by Land Information New Zealand (LINZ).
front_of_property_latitude double Latitude of the front of the building.
front_of_property_longitude double Longitude of the front of the building.
front_of_property_nztm_x_coordinate double Easting (X-axis) value of the property's front in the NZTM2000 national grid reference system, used for geocoding by Land Information New Zealand (LINZ).
front_of_property_nztm_y_coordinate double Northing (Y-axis) value of the property's front in the NZTM2000 national grid reference system, used for geocoding by Land Information New Zealand (LINZ).
general_electorate_code string Unique code for the General Electorate.
general_electorate_name string Name of the General Electorate.
linz_parcel_id string Unique LINZ identifier for the address record.
maori_electorate_code string Unique code for the Māori Electorate.
maori_electorate_name string Name of the Māori Electorate.
match_level string Accuracy level of the geocoded coordinates.
mesh_block_code string Unique identifier for the Mesh Block.
property_purpose_type string Classification of property use: Business, Farm, Holiday Home, Residential, or Empty section.
regional_council_code string Unique code for the Regional Council.
regional_council_name string Name of the Regional Council.
territorial_authority_code string Unique code for the Territorial Authority.
territorial_authority_name string Name of the Territorial Authority.

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the nzl_regional_geocodes object. All available attributes and full request and response structures are shown below.

Request 
{
  ...,
  "attributes": {
    "nzl_regional_geocodes": [
      "addressable",
      "centroid_of_property_latitude",
      "centroid_of_property_longitude",
      "centroid_of_property_nztm_x_coordinate",
      "centroid_of_property_nztm_y_coordinate",
      "front_of_property_latitude",
      "front_of_property_longitude",
      "front_of_property_nztm_x_coordinate",
      "front_of_property_nztm_y_coordinate",
      "general_electorate_code",
      "general_electorate_name",
      "linz_parcel_id",
      "maori_electorate_code",
      "maori_electorate_name",
      "match_level",
      "mesh_block_code",
      "property_purpose_type",
      "regional_council_code",
      "regional_council_name",
      "territorial_authority_code",
      "territorial_authority_name"
    ]
  }
}
Response 
{
  ...,
  "enrichment": {
    "result": {
      "nzl_regional_geocodes": {
        "front_of_property_nztm_x_coordinate": double,
        "front_of_property_nztm_y_coordinate": double,
        "centroid_of_property_nztm_x_coordinate": double,
        "centroid_of_property_nztm_y_coordinate": double,
        "linz_parcel_id": "string",
        "property_purpose_type": "string",
        "addressable": "string",
        "mesh_block_code": "string",
        "territorial_authority_code": "string",
        "territorial_authority_name": "string",
        "regional_council_code": "string",
        "regional_council_name": "string",
        "general_electorate_code": "string",
        "general_electorate_name": "string",
        "maori_electorate_code": "string",
        "maori_electorate_name": "string",
        "front_of_property_latitude": double,
        "front_of_property_longitude": double,
        "centroid_of_property_latitude": double,
        "centroid_of_property_longitude": double,
        "match_level": "string"
      }
    }
  }
}
Experian Address Validation

Dataset reference