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"
}

Available Response Data

No response data documented for this endpoint.

Request Schema

Field Name Type Required Description
email string No The email address to search for. Example: jsmith1998@example.co
phone string No The phone number to search for. Example: 0491222111

Technical Use Cases

verified

Lead Enrichmen

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.

Webhooks & Events

notifications
Synchronous lookup

Polling/Webhooks are not required.

Compliance & Security

verified_user ISO 27001 Certified
enhanced_encryption AES-256 Encryption
public Australian Data Sovereignty
Integration & Support

Common Questions

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.

BACK TO TOP