How do I get NZ Post deliverable addresses?
It is possible to limit your search to postal addresses only, if your objective is to collect only addresses that NZ Post deliver to.
This is achieved by passing
Here's an example of how to setup the widget to only return postal addresses:
This page has a description of all of the attributes that the Address Metadata API returns:
Address Metadata API Response
AddressFinder returns both a postal and physical address where both exist. A postal address means that the data comes from NZ Post, and NZ Post deliver to that address. However, there are many addresses that NZ Post do not deliver to (they are physical, but not postal addresses).
Below is an example where there is both a postal and physical address.
We return both addresses in the search results, but both search results point to the one address record below.
"mailtown" is the correct postal town/city. In this case the address is physically in Thornbury, but the NZ Post delivery is RD3 from Riverton (Mailtown).
Mailtown will be blank if the address searched for and select is not delivered to by NZ Post.
| ||19 Broderick Street, Thornbury 9883|
| ||19 Broderick Street, RD 3, Riverton 9883|
| ||Southland District|
| ||Southland Region|
| ||Broderick Street|
| ||19 Broderick Street|
| ||RD 3|
| ||Riverton 9883|
See also FAQ: What’s the difference between ‘city’ and ‘mailtown’?