Addressable

A simple RESTful JSON web API that allows website, web and desktop application developers to easily implement address verification, geocoding and autocomplete for New Zealand and Australia .

Businesses who need to regularly capture address data use Addressable to:

There are no onerous licensing restrictions, unlike the Google Places Autocomplete service, which limits what you can fetch, store and how you use it .

We use open data from official government sources and those cost savings are reflected in our low subscription prices.

Our servers are located in AWS Sydney to provide fast and reliable service to our local customers.

Our clients range from local business, government agencies to publicly listed organisations.

Documentation

Autocomplete

URL:

https://api.addressable.dev/v2/autocomplete

GET Parameters (required):

q
The query string
country_code
The ISO 3166 Country Code. Accepted: [NZ, AU]
api_key
Your API Key. Available upon free registration

GET Parameters (optional):

type
A comma separated list of types from "number, street, locality". The data set offers individual results for locality centre points and street centre points as well as address numbers. Example usage: add the "locality" filter when running autocomplete for a suburb form field.
max_results
Maximum number of results to return. Must be an integer from 1 to 10. Default: 5.

Successful response

[{ "street_number": "214-220", "street": "Queen Street", "locality": "Auckland Central", "city": "Auckland", "region": "Auckland", "postcode": "1010", "meshblock": "0437101", "lon": 174.765469, "lat": -36.849304, "formatted": "214-220 Queen Street, Auckland Central, Auckland" }]

Supported Fields

NZ:street_number street locality city region postcode meshblock lon lat formatted
AU:building_name unit_details street_number street locality region postcode lon lat formatted

Sample GET query

https://api.addressable.dev/v2/autocomplete?api_key=YOUR_API_KEY&country_code=NZ&q=220+Queen+Auc

Sample cURL code

curl "https://api.addressable.dev/v2/autocomplete?api_key=YOUR_API_KEY&country_code=NZ&q=220+Queen+Auc"

CORS: Cross-Origin Resource Sharing is enabled on the API endpoints so you can use the service from your javascript application.

JSFiddle Example: jQuery UI Autocomplete

Profile

URL:

https://api.addressable.dev/v2/profile

GET Parameters (required):

api_key
Your API Key. Available upon free registration

Successful response

{"id":1,"email":"[email protected]","subscription_expires_on":"2000-01-01"}

Sample GET query

https://api.addressable.dev/v2/profile?api_key=YOUR_API_KEY

Sample cURL code

curl "https://api.addressable.dev/v2/profile?api_key=YOUR_API_KEY"

Error responses:

HTTP Code:
401
Response
{"errors":[{"error_type":"request","message":"API key invalid"}]}
HTTP Code:
429
Response
{"errors":[{"error_type":"request","message":"Rate limit exceeded"}]}

Subscriptions

Requests from a free account are rate limited to 100 per calendar day.

With a valid subscription, you can have up to 30,000 requests per day. No setup costs, cancel any time, not for resale. Accounts are upgraded instantly upon payment. Payment is available from your account page .

Pricing NZ

Period Monthly Cost One off payment Discount
1 month $98 $98
6 months $73 $438 Save 26%
12 months $56 $672 Save 43%

Pricing AU

Period Monthly Cost One off payment Discount
1 month $248 $248
6 months $183 $1101 Save 26%
12 months $141 $1696 Save 43%

About Addressable

We've been building enterprise web applications since 1999,
ordering geospatial data when it arrived in the post on CD.
We built our first geocoder to power New Zealand's largest open-content business directory Zenbu before Google even offered that service in NZ.
In 2015 Addressable was rebuilt from scratch to leverage the latest open source technology for blazing fast search.
We love web APIs and geodata. [email protected]

Data Source Attribution

AU

Incorporates or developed using G-NAF © Geoscape Australia licensed by the Commonwealth of Australia under the Open Geo-coded National Address File (G-NAF) End User Licence Agreement.

Contains data sourced under license, including CC-By license from GeoNames

NZ

Contains data sourced under license, including CC-By license from

Meshblock values are taken from the latest available boundaries.

Terms and Conditions Privacy Policy