Address

Address Validate API

Q: What kinds of corrections does the validator make?

What kinds of corrections does the validator make? | answer: Spelling fixes to street and suburb names, changes to the street type (Rd vs St vs Pl), changes to the unit type (Flat to Unit), postcode corrections to an adjacent postcode, suburb changes to an adjacent suburb, and street number range corrections (e.g. “123 Smith St” matching “123-125 Smith St”). Anything more than that and the address comes back invalid.

Q: Can I send just full_address and skip the components?

Yes. full_address on its own is one of the three valid input modes. The validator will parse it and resolve to GNAF. Useful when you’ve captured the address as free text without component parsing.

POST

/address_validate

LIVE

Tests a supplied address against the GNAF database and returns a quality score from 0 to 10, plus the matched address with any corrections applied. The validator will fix minor mistakes (spelling errors in the street or suburb, the wrong street type, a postcode that's one off) so long as the rest of the address is still resolvable. You get the corrected address back along with a list of every change that was made.

Request a Demo Contact Sales

Home
API
Endpoints
Address
Address Validate API

Address Validate API

Example Request

POST

request.json

key Auth: BearerAuth

{
  "street_address": "Unit 12B, 123-125 Smith St",
  "suburb": "Smithtown",
  "state": "ACT",
  "postcode": "2000",
  "suburb_state_postcode": "Smithtown ACT 2000",
  "full_address": "Unit 12B, 123-125, Smithtown, ACT 2000"
}

Request Schema

street_address

Required

string · (4 to 100 chars)

First line of the address. Requires at least one of suburb or postcode.

suburb

Optional

string · (2 to 60 chars)

Suburb name. Requires street_address.

state

Optional

enum

ACT, NSW, NT, QLD, SA, TAS, VIC, WA. Requires street_address.

postcode

Optional

string · (3 to 4 chars)

Postcode. Requires street_address.

suburb_state_postcode

Required

string · (4 to 100 chars)

Combined suburb, state and postcode. Requires street_address.

full_address

Conditional

string · (4 to 255 chars)

Full address as a single string. Use this when you don't have the components separated.

Available Response Data

5 Data Points

inventory_2 What You Receive

fact_check

valid

boolean indicating whether the address could be matched

speed

score

0 to 10 indicating match quality. Calculated as 10 - number of address changes minimum 0. Null if invalid.

fact_check

matched_address

the resolved address with address_id GNAF, full_address, address_line_1, address_line_2, suburb, state, postcode, plus parsed components: unit_type, unit_number_prefix, unit_number, unit_number_suffix, level_type, level_number_prefix, level_number, level_number_suffix, street_number_1_prefix, street_number_1, street_number_1_suffix, street_number_2_prefix, street_number_2, street_number_2_suffix, lot_number_prefix, lot_number, lot_number_suffix, postal_delivery_type, postal_delivery_number_prefix, postal_delivery_number, postal_delivery_number_suffix, street_name, street_type, street_suffix

location_on

address_changes

array of changes made to the supplied address. Each entry has field and change e.g. "Changed from ST to PL"

fingerprint

api_reference for log tracing

lock Full API documentation provided after vetting from our compliance team. Request sample response arrow_forward

By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+

Phone & Email Records

40M+

Adverse Court Records

2BN+

Australian Universe Records

18M+

Real Estate Records

7M+

Deceased Records

980M+

Social Media & Employment Records

Practical Applications

Technical Use Cases tag

done_all

Form-level validation at submit time

Run a validation pass when a customer submits an address. Surface the corrected address back to them for confirmation if changes were made, which catches typos before they get baked into your customer record.

cleaning_services

Bulk database cleansing

Run customer addresses through validation as part of a periodic data hygiene job. Update records where the validator returns a corrected address.

psychology

Score-based routing

A score of 10 is a clean pass-through. Scores 7 to 9 typically indicate minor corrections worth showing to the customer. Below 5 is worth a human review. Build your routing logic on the score.

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user

ISO 27001 Certified

enhanced_encryption

AES-256 Encryption

public

Australian Data Sovereignty

Integration & Support

Common Questions tag

Everything you need to know about implementation details and compliance infrastructure.

Filter by topic

help

Compliance Team

Global Data Support

Need help planning your custom integration or understanding our compliance coverage? Our team is here to assist.

rocket_launch Implementation

What kinds of corrections does the validator make?

add

What kinds of corrections does the validator make? | answer: Spelling fixes to street and suburb names, changes to the street type (Rd vs St vs Pl), changes to the unit type (Flat to Unit), postcode corrections to an adjacent postcode, suburb changes to an adjacent suburb, and street number range corrections (e.g. “123 Smith St” matching “123-125 Smith St”). Anything more than that and the address comes back invalid.

rocket_launch Implementation

How is the score calculated?

add

Starts at 10 and drops by 1 for each change made to the supplied address. Minimum is 0. So a perfect pass-through with no changes gets 10. One spelling correction gets 9. A spelling fix plus a postcode correction gets 8. And so on.

rocket_launch Implementation

Can I send just full_address and skip the components?

add

Yes. full_address on its own is one of the three valid input modes. The validator will parse it and resolve to GNAF. Useful when you’ve captured the address as free text without component parsing.

Try it Live

API Testing Sandbox tag

Test the Address Validate API directly in your browser with live mock data and see instant results.

rocket_launch Request Sandbox Access

Access to live sandbox environments requires manual approval from our compliance team.

Enquire now

Ready to integrate Address Validate API?

Talk to our team about credentials, sandbox access and the right combination of endpoints for your workflow.

Call 03 9948 4089 · sales@globaldata.net.au

Request a Demo Contact Sales