Address

Address Validate API

Address Validate tests an address you hold against the GNAF address database and returns the matched address with a score from 0 to 10. Misspelt streets, wrong street types and adjacent postcodes are corrected before the record reaches your database.

Every valid match carries a GNAF address ID, accepted directly by Property Detail and Real Estate Search
One call returns the standardised address split into unit, level, street number, street name, suburb, state and postcode

Get API access Talk to us

For developers

After the technical detail?

For the technical detail, go to the API documentation. It holds the request and response schema, the integration guides and the error codes for this endpoint.

Request and response schema
Correction rules and error codes

View developer documentation

Accounts start in the sandbox. Production keys are issued once the account is approved.

Encrypted in transit and at rest Handled under the Australian Privacy Principles

What the check gives you

Correcting customer addresses before they reach your database

An address typed by a customer or keyed by staff often differs from the address in the GNAF address database. Address Validate compares what you hold with the GNAF address database and corrects the differences it is permitted to correct. The matched address, the list of changes made and a score come back in the same response, so your system can store the standardised record and flag anything that needed more than a minor correction.

Whether the address exists

The response states whether the address is valid. A valid address is one that was matched to a record in the GNAF address database, after any permitted corrections.

The standardised address

The matched address is returned as a full address, as two address lines, and as separate components: unit, level, lot, street number range, street name, street type, street suffix, postal delivery type, suburb, state and postcode.

The GNAF address ID

Every matched address carries its GNAF ID. The same ID is accepted by Property Detail and Real Estate Search, so one validated address can be reused without matching it again.

What was changed, and how well it matched

The address_changes list names each field that was corrected and the change made. The score is 10 minus the number of changes, so a 10 needed no correction and a low score needed several.

How a check runs

One call, answered in the same response

Your system sends the address in one of three forms. The address is matched to the GNAF address database and the result comes back in the same call, with no polling.

Accepted inputs are a street address plus a suburb or postcode, a street address plus a combined suburb, state and postcode line, or a full address as one string. The state field accepts ACT, NSW, NT, QLD, SA, TAS, VIC or WA.

Reading the result

What each answer means for the record in front of you

The response carries a valid flag and a score. Together they tell your team whether to store the address as returned or to look at it again.

Valid

The address matched the GNAF address database

The matched address and its GNAF ID are returned. A score of 10 means no correction was needed. A lower score means one or more permitted corrections were applied, and each is listed in address_changes.

Not valid

No matching address was found

The matched address is returned as an empty object and the score is null. The address could not be matched to the GNAF address database even after the permitted corrections were tried.

What it costs

A monthly subscription, drawn down as you run checks

Your subscription is credited to your account each month and each check consumes credits from it. If you go past the included amount, further checks are charged at a per-check rate. The rate depends on the volume you commit to, so the sales team is the fastest way to find where your business lands.

Volume-based pricing
No lock-in contract

How billing works

Subscribe monthly, spend it as credits

The monthly subscription arrives as credits on your account.
Each check draws down credits as it runs.
Checks beyond the included credits are billed per check.
Higher monthly volume moves you to a lower rate.

Talk to sales about volume

Related checks

Others in Address

Address Validate Bulk applies the same rules to up to 200 addresses in one call. Address Autocomplete prevents the errors at the point of entry. Property Detail and Real Estate Search accept the GNAF ID this check returns.

Address Autocomplete API Address Lookup by Contact API Address Validate Bulk API Property Detail API Real Estate Search (Bulk) API Real Estate Search API

All Address endpoints

Questions

Questions we get asked about address validation

Do we need a developer to implement this?

Yes. Address Validate is a REST endpoint that takes a JSON request and returns a JSON response, so a developer connects it to your CRM, onboarding form or batch process. A sandbox with a separate test dataset is provided at no usage cost, so the integration can be built and tested before production keys are issued.

What does our system need to send?

One of three combinations. A street address plus at least one of suburb or postcode. A street address plus a combined suburb, state and postcode line such as Smithtown ACT 2000. Or a full address as a single string, such as Unit 12, 123 Smith Street, Smithtown 2000 ACT.

Which corrections will the check make?

Spelling corrections to the street name or suburb name. A change of street type, for example Rd to St. A change of unit type, for example Flat to Unit. A change of postcode or suburb to an adjacent one. A change of street number where the number falls inside a numbered range. Each correction is only made where the street number and street name are valid in the resulting suburb or postcode, and each one is listed in the response.

What does the score mean?

The score runs from 0 to 10 and is calculated as 10 minus the number of changes made to the supplied address, with a minimum of 0. An address that needed no correction scores 10. An address that is not valid has no score.

Where does the address data come from?

Addresses are matched against the GNAF address database. The GNAF ID returned for a valid match is the address_detail_pid on the GNAF table.

Is there a limit on how many addresses we can check?

The API allows 600 requests per minute by default, measured as a rolling average. Requests beyond that receive a 429 response until the rate drops. A higher limit can be requested through Global Data support with a description of the operational need. For large files, Address Validate Bulk takes up to 200 addresses in one request.

Is the address we send stored by Global Data?

Personally identifiable information sent in a request is not stored or retained unless it is needed to process that request. Query data is stripped of PII before it is kept for audit. Data in transit and at rest is encrypted, and retention follows the Australian Privacy Act and the Australian Privacy Principles. Global Data is not a credit bureau and does not create an access footprint on any record.

Getting started

The first step to access is a conversation

New accounts begin with sandbox access, and production API keys are issued once the account has been commercially approved.

Get API access Talk to us

Call 03 9948 4089, 9am–5pm AEST Monday to Friday

Encrypted in transit and at rest

Handled under the Australian Privacy Principles

ISO 27001 Certified