Address Services

Address Autocomplete
Address Cleansing
Address Geocoding
Postcode Finder

Address Cleansing

Verify and cleanse NZ addresses and postal codes using an Excel CSV Spreadsheet

Run any Addy API live with Addy Swagger UI on us for free with 'demo-api-key' API key


Enter your address into a CSV and upload it.


Track the bulk address validation progress and matching accuracy.


Download the list of validated address results.

What are the benefits of address validation?


- validate thousands of addresses in minutes


- addresses are matched against authoritative NZ Post and LINZ datasets


- all verified addresses are in the same consistent address format


- new metadata such as the latitude and longitude geocoordinates and Stats NZ Census metadata will be added too


- missing attributes such as postal codes, suburbs and cities will be added to the addresses


- using the Addy ID or Parcel Number you can uniquely identify addresses for duplication detection


- Verify 500 addresses free per month, choose a plan if you need more

Output Address Fields

The table below describes each column in the Excel CSV spreadsheet. To find a complete description of all the fields, see the response properties for the Address Details API.
Column NameDescriptionExample
ReasonThe reason why address validation failed. This field will be blank if the address was matched successfullyReview address. Used next best match.
PrefixPrefix address text that was removedReception or ABC Building
AddressFull address in a single line80 Queen Street, Auckland Central, Auckland 1010
Display LineHolds the single line address display nameFloor 2, 1 Blair Street
StreetHolds the name and type of the streetBlair Street
SuburbHolds the name applied to a group of geographically associated streetsTe Aro
CityHolds the name of the Town/City provided by Land Information New Zealand (LINZ)Wellington
MailtownHolds the name of the Town/City/Mailtown associated with this delivery pointWellington
PostcodeHolds the four digit code defined by New Zealand Post, which is used to describe the locations linked to sorting zones for mail sorting purposes622
XHolds the longitude coordinates in WGS84 format174.7835236
YHolds the latitude coordinates in WGS84 format-41.29302216
IDHolds the unique Addy Identifier2392921
DPIDHolds the unique reference number assigned by NZ Post to each delivery point address1500136
LINZ IDHolds the unique reference number assigned by Land Information New Zealand (LINZ) to each street address25003
Parcel IDHolds the unique spatial object number representing a land parcel where the postal address resides as assigned by Land Information New Zealand (LINZ)3757439
MeshblockHolds the foreign key value to link to census and statistical datasets as assigend by Statistics New Zealand (Stats NZ)2135700
NumberHolds the base street number. For Rural addresses these are allocated by territorial authorities1
RD NumberHolds the rural delivery route number
AlphaHolds the alpha component of a street numberB
Unit TypeHolds the category description of a sub-dwelling type within a building of building compiles. This is used in conjunction with the Unit Number address elementFlat
Unit NumberHolds the address elements that identifies a specific deliver sub dwelling delivery point within a building or building complex3
FloorHolds the Floor type and identifier in a multi level buildingFloor 2
TerritoryHolds the territorial authority of the address. See districts of NZ<Wellington City
RegionHolds the regional authority of the address. See regions of NZWellington
BuildingHolds the building property name for a recognised significant building
TypeHolds the type of delivery point (Urban, Rural, PostBox, NonPostal)Urban
Box Bag NumberHolds the PO Box/Private Bag number
Output Field 1Holds the correctly formatted address in line 1Floor 2
Output Field 2Holds the correctly formatted address in line 21 Blair Street
Output Field 3Holds the correctly formatted address in line 3Te Aro
Output Field 4Holds the correctly formatted address in line 4Wellington 6011
ModifiedHolds the last modified date of the address22/1/18
PAF SourceHolds a flag to state if the address was sourced from the New Zealand Postal Address File (TRUE) or Land Information New Zealand (FALSE)TRUE
DeletedHolds a flag to state if the address was deletedFALSE
SuggestionsHolds the list of Address SuggestionsList of Addresses

Sign up

Full support

Sign up

Full support

Address Services

Address AutocompleteAddress CleansingAddress GeocodingPostcode FinderPricingSign inSign up
© 2023 Addy LimitedTerms & Conditions
Made in Auckland, New Zealand
Looking for Addy Australia?