Loading...
Sign in to see the examples with your own API key.

Data Attribution

Our address data is G-NAF Core, the open edition of the Geocoded National Address File, produced by Geoscape Australia from contributions by the Australian state and territory governments. Geoscape Australia licenses it under the Open G-NAF Core End User Licence Agreement (EULA), which is based on the Creative Commons Attribution 4.0 (CC BY 4.0) licence.

Attribution statement

If you display or redistribute address data obtained from this service, include the following attribution, with "Copyright and Disclaimer Notice" linked to Geoscape's notice and the licence name linked to the licence:

Incorporates or developed using G-NAF Core © Geoscape Australia 2023 Copyright and Disclaimer Notice. Licensed by Geoscape Australia under the Open G-NAF Core End User Licence Agreement. 

Geoscape provides the data as it is, without warranty of accuracy or completeness; its copyright and disclaimer notice has the full terms.

How we change the data

We do not serve G-NAF Core exactly as released. We reformat each address into the fields and single-line label our API returns, index it for search, keep addresses withdrawn from later releases so stored ids still resolve, and derive one place per suburb, state and postcode, with its centre, for the Location API.

Mail-use restriction

The G-NAF Core EULA carries one restriction beyond standard CC BY 4.0, and it applies to you as a user of this service:

You must not use address data from this service to generate an address, or compile addresses, for sending mail unless you have verified that each address can receive mail using a source other than G-NAF — for example, the addressee confirming it, a verified mailing database, or your own mailing records.

A customer picking or confirming their own address in your checkout or sign-up form is that verification, so storing it as their delivery or billing address is fine. Generating addresses, or building a list of them, to send mail to is not.

Coverage

Coverage is Australia: every physical address in G-NAF Core across NSW, VIC, QLD, SA, WA, TAS, NT and the ACT, refreshed with each quarterly G-NAF release. New Zealand addresses are served only through the New Zealand addresses add-on, below.

Business data

The Companies and Company APIs use the ABN Bulk Extract, published weekly by the Australian Business Register under the Creative Commons Attribution 3.0 Australia licence. If you display or redistribute business data obtained from this service, credit the source:

Contains data from the Australian Business Register (ABN Bulk Extract), licensed under CC BY 3.0 AU. 

We hold active ABNs only, refreshed from each weekly extract. A sole trader's own name is never searchable.

New Zealand address data

The New Zealand addresses add-on uses LINZ's NZ Addresses, from Toitū Te Whenua Land Information New Zealand, licensed under CC BY 4.0. If you display or redistribute New Zealand address data obtained from this service, credit LINZ, with "LINZ Data Service" linked to https://data.linz.govt.nz/:

Sourced from the LINZ Data Service and licensed for reuse under the CC BY 4.0 licence. 

Postcodes. LINZ's data has no postcodes. The New Zealand postcodes we return are unofficial: they come from the open_nz_postcodes project, released under CC0, not from NZ Post, and are wrong for roughly 5 addresses in 100. Every address says how its postcode was assigned (postcode_source) and that it is not NZ Post's own (postcode_official is false).

More information

Top