Address Lookup by Contact API

GET
/address_lookup_by_contact
LIVE

Returns the GNAF ID which corresponds to a given email address or phone number from the Global Data universe.

Example Request

GET
request.json
key Auth: BearerAuth
{
  "message": "Ok",
  "address_id": "GANSW716615055",
  "record_date": "2021-01-01",
  "api_reference": "738d9a89-b6fe-4fc1-96be-1389b2a506a2"
}

Request Schema

email
Optional
string

The email address to search for. Example: jsmith1998@example.co

phone
Optional
string

The phone number to search for. Example: 0491222111

Available Response Data

4 Data Points
01
monitor_heart

Message Status

02
fact_check

Primary GNAF Address ID matched to the contact

03
schedule

Record Date

Date the link was established or last verified

04
fingerprint

API Request Reference

lock Full API documentation provided after vetting from our compliance team.
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

Sandbox Environment

The Global Data API provides two distinct environments to support your development and production lifecycles.

Practical Applications

Technical Use Cases tag

verified

Lead Enrichment

Automatically populate physical mailing addresses for inbound leads when only a phone number or email is provided.

verified

Skip Tracing

Track down updated residential information for collections or legal notifications using historic digital footprints.

Real-time Notifications

Webhooks & Events tag

notifications
Synchronous lookup

Polling/Webhooks are not required.

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.

help_center General

What happens if an email links to multiple addresses?

add

The system returns the most recently verified residential GNAF ID associated with that contact point, based on the record_date.

Try it Live

API Testing Sandbox tag

Test the Address Lookup by Contact 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.