Questions, answered
Everything about scope, sovereignty, integration, billing and licensing. Can’t find it? Email support@wattleaddr.com.au.
Product & scope
What is WattleAddr?
WattleAddr is an Australian address API — autocomplete, verification, standardisation and geocoding — built on the open Geocoded National Address File (G-NAF) and hosted entirely in Australia. You add it to any form so people can type a few characters and pick a real, correctly formatted Australian address.
What can the API do?
Three things: autocomplete (type-ahead suggestions as a user types), verify & standardise (match free-text input to a canonical address with clean components and a confidence score), and geocode (return latitude and longitude for a matched address).
What can it not do?
WattleAddr confirms that an address exists and where it is — it is not a postal deliverability or mail-house service. It does not provide Australia Post AMAS/PAF certification, DPIDs or barcodes, and must not be relied on to decide whether mail can be delivered. We are deliberately upfront about this so you buy the right tool.
Which addresses are covered?
Every current, geocoded physical address in Australia that appears in G-NAF — the authoritative national address file. It is refreshed quarterly, and each API response tells you which G-NAF release it came from.
How accurate and current is the data?
The data is sourced from Geoscape Australia’s G-NAF and updated each quarter. We re-ingest each release and swap it in with zero downtime. Because it reflects the national dataset, coverage and formatting are consistent across the country.
Do you support international addresses?
No — WattleAddr is Australia-only by design. That focus is part of what lets us keep everything onshore and fast.
What’s the difference between autocomplete, verify and geocode?
Autocomplete is for interactive forms (suggestions as someone types). Verify takes a full free-text address and finds the best canonical match — useful for cleaning data you already hold. Geocode returns coordinates for a matched address, for maps, routing or catchment logic.
Data sovereignty & privacy
Where is my data hosted?
Entirely in Australia. Primary infrastructure is in Sydney with a cross-state backup in Melbourne, on Australian cloud infrastructure (Binary Lane). Nothing is processed or stored offshore.
Does any data leave Australia?
No. Address queries are served from Australian infrastructure and never routed or cached overseas. There is no US CDN or offshore edge in the request path.
Do you send my customers’ keystrokes to Google or any third party?
No. Unlike some popular autocompletes, your end-users’ input never touches a third-party ad platform. Their addresses stay with us, in Australia.
Do you store the addresses my users type?
Queries and matched results are recorded in a per-workspace search log for debugging, usage and support. Retention is configurable (for example 7, 30, 90 or 365 days), after which entries are purged.
Can I reduce what’s stored?
Yes. You can shorten retention, and you can choose to store queries hashed or omit raw query text entirely — useful if you want to minimise the personal information held.
Are you IRAP certified?
Our infrastructure is architected to support IRAP-aligned workloads, but we do not claim any specific certification. We are precise about this rather than over-claiming.
Are you compliant with the Privacy Act and the APPs?
We handle personal information in accordance with the Privacy Act 1988 (Cth) and the Australian Privacy Principles. See our Privacy Policy for detail.
Can I get a Data Processing Agreement?
Yes. Our DPA covers our processing of end-user address data on your behalf, all within Australia. It is available to customers and is standard for Enterprise and Government accounts.
Is it suitable for government and regulated industries?
That is exactly who we built it for. All-Australian hosting, configurable retention, a DPA, data-residency attestation and manual/PO billing make WattleAddr a fit where offshore address autocomplete is not allowed.
Getting started & integration
How do I get started?
Create a free account in the console, create a workspace, and grab a publishable key (for the browser) and a secret key (for your backend). Then call the API or drop in the widget. You can be live in minutes.
What’s the difference between secret and publishable keys?
Secret keys authenticate server-side calls and must be kept private (use an Authorization: Bearer header). Publishable keys run in the browser and are locked to the domains you allow, so they can’t be misused elsewhere.
Is there a drop-in widget?
A lightweight JavaScript autocomplete widget lets you attach type-ahead to any input with a publishable key and handles session tokens for you. You can also call the REST API directly.
What platforms and frameworks are supported?
Anything that can make an HTTPS request. The REST API works with any language or framework; the browser widget works with any front-end. Server SDKs and platform plugins are on the roadmap.
What are the rate limits?
Each key has a burst limit appropriate to your plan. If you exceed it you’ll get a 429 with a Retry-After header. Monthly usage is governed by your plan’s quota.
Is there a test mode?
Yes. Test-mode keys let you build and experiment without affecting billing.
What happens if a key is leaked?
Rotate or revoke it instantly in the console — revocation takes effect immediately. We only ever store a prefix and a hash of each key, never the raw value.
Billing & plans
What plans are available?
Three: Free (a generous monthly allowance to try and build), Pro (a single plan that scales with usage-based overage), and Enterprise/Government (custom volume, residency attestation, DPA, SLA and PO billing).
What counts as a billable lookup?
One address-search session. All the autocomplete keystrokes a person types while finding one address, plus the final selection, collapse into a single billable lookup.
Are autocomplete keystrokes billed?
No — autocomplete keystrokes are treated as fair-use. You’re only billed for completed lookups, so a busy checkout stays affordable.
What happens if I exceed my quota?
On the Free tier, billable requests stop once you reach the cap (until the next period or an upgrade). On Pro, you keep going and simply pay overage — no hard stop. The console shows usage and projections before you get there.
How does overage work?
Pro includes a monthly allowance of lookups, then bills any extra per 1,000 at the rate shown on the pricing page. No forced upgrade.
What payment methods do you accept?
Card and bank direct debit, handled securely by our Australian payment processor (Pinch). Government and eligible enterprise accounts can pay by EFT or purchase order on manual invoicing.
Can I pay by invoice or purchase order?
Yes — manual invoicing (EFT / PO) is available for Enterprise and Government accounts, and is the default for procurement.
Do prices include GST?
Prices are in Australian dollars. GST is applied where it applies, and you’ll receive a valid tax invoice.
Is there a free tier or trial?
Yes — the Free tier is ongoing (not a time-limited trial), with a monthly lookup allowance and no card required.
How do I cancel, and are fees refundable?
You can cancel any time in the console; cancellation takes effect at the end of the current billing period. Fees are non-refundable except where required by the Australian Consumer Law.
Data, licensing & ownership
Where does the address data come from?
From G-NAF (the Geocoded National Address File), © Geoscape Australia, provided as open data. WattleAddr ingests, indexes and serves it through our API.
Do I need to attribute G-NAF?
Yes — the open G-NAF licence requires a short attribution to Geoscape Australia wherever you surface address data. We provide the exact wording in our docs, and it also appears in our own site footer.
Can I store or cache the addresses I retrieve?
Yes, you can cache a result for your own operational use (for example, saving the address a customer selected). Because G-NAF is refreshed quarterly and identifiers can change between releases, store the returned formatted address and components too — not just the identifier.
Who owns the data?
G-NAF remains the property of Geoscape Australia and its licensors, used under the open licence. You own your application and your data; we don’t claim ownership of the addresses you process.
Reliability, security & support
What’s your uptime and do you offer an SLA?
We aim for high availability and fast responses (autocomplete typically well under 150 ms in-country). Formal SLAs are available for Enterprise customers.
Is there a status page?
A status page reports API, engine and dataset status, including the current G-NAF release. The API also exposes a /v1/status endpoint.
How do I get support?
Free tier has community/email support; Pro includes email support; Enterprise adds priority and dedicated support. Reach us at support@wattleaddr.com.au.
How do I delete my data or account?
You can delete workspaces and rotate/revoke keys in the console, and adjust search-log retention. To delete your account or request erasure, contact us and we’ll action it subject to any legal retention requirements.
How do you secure API keys and data?
Keys are shown once and stored only as a prefix plus a hash; data is encrypted in transit and hosted on access-controlled Australian infrastructure with least-privilege access, logging and backups. See our Privacy Policy and DPA (Annex B) for detail.
Still have a question?
Start free and see it working, or talk to us about Enterprise and Government needs.