Usage policy

G-NAF is licensed under the Open Geo-coded National Address File (G-NAF) End User Licence Agreement. Include the attribution in the footer of this site on public products that use the data.

Do not use this data to compile a list for sending mail without verification from a secondary source.

Boundary data from the Australian Bureau of Statistics is used under Creative Commons Attribution 4.0 International, and the Modified Monash Model 2023 by Mesh Block from the Department of Health and Aged Care under Creative Commons Attribution 2.5 Australia. Attribute both where you publish derived figures.

Each key has a monthly lookup allowance set by the account's plan, reset at 00:00 UTC on the first of the month, and a burst limit set by the plan. Bulk requests accept up to 100 queries and count once per query. CSV jobs count once per successfully processed row. Paid plans are billed monthly or annually in Australian dollars through Stripe and can be cancelled at any time from the account. Keep server keys private and revoke them if exposed. Use a browser key with an allowed website list for public lookup forms.

Respect the limits and the Retry-After header. Do not use multiple accounts to avoid a limit or disrupt access for other users. Read the headers and error codes.

Keys that enumerate postcodes, repeat the same lookup at volume or send mostly failing requests are slowed to one request a second for an hour, longer if it repeats, and you are emailed.