Australia Residential Lookup

3 min

Data Zoo’s proprietary opt-in permission based marketing database.

For Authorization Get Session Token from Authentication page.

* Verification Outcome – Returns KYC verification * Consumer Consent – N/A * Mandatory Input – Name and Phone number * Verifies – Name, DOB, Address and Phone (indicating landline or mobile) number * Returned Data - identity of the data source

POST

https://idu-test.datazoo.com/api/v2/verify

Header Parameters

Authorizationstringrequired
Description
sessionToken obtained via the Authentication call

Body Parameters

dataobjectrequired
Description
request body sent to the API
- countryCodestringrequired
  Description
  AU
- servicearrayrequired
  Description
  Australia Residential Lookup
- clientReferencestring
  Description
  a client reference field
- firstNamestringrequired
  Description
  the first name of the identity owner
- middleNamestring
  Description
  the middle name(s) of the identity owner
- lastNamestringrequired
  Description
  the last name of the identity owner
- dateOfBirthstring
  Description
  in YYYY-MM-DD (preferred) or DD-MM-YYYY format
- addressElement1string
  Description
  the street level address of the identity owner
- addressElement3string
  Description
  the suburb address of the identity owner
- addressElement4string
  Description
  the state address of the identity owner
- addressElement5string
  Description
  the postcode of the address of the identity owner
- identityVariablesobjectrequired
  Description
  other elements for verification
  - phoneNostringrequired
    Description
    mobile or landline phone number of the identity owner

Response

countryCodestring
Description
Australia
clientReferencestring
Description
the client reference (if given as input)
reportingReferencestring
Description
a reference number generated which is unique to each transaction.
validationErrorsstring
Description
Returned with HTTP status code 400 when the request contains invalid or improperly formatted input data.
matchStatusstring
Description
"Full Match 1+1 Verification" "No Match"
searchErrorMessagestring
Description
"" error message returned querying the data source
safeHarbourboolean
Description
true or false
searchStatusstring
Description
"Successful" "Not Successful"
serviceResponsesobject
Description
Verification Details with "Australia Residential Lookup" returned as the Service Identifier.
- statusinteger
  Description
  0 - identityVerified TRUE - element verifications all TRUE 1 - identityVerified TRUE - element verifications not all TRUE 2 - identityVerified FALSE - sourceStatus SUCCESSFUL 3 - identityVerified FALSE - sourceStatus NOT SUCCESSFUL
- sourceStatusstring
  Description
  "Successful" "Unsuccessful"
- errorMessagestring
  Description
  "" error message(s) from the data source. Example, "Error querying data source".
- identityVerifiedboolean
  Description
  true or false
- safeHarbourScorestring
  Description
  "N/A" * For more information, refer to Safe Harbour Scores page
- nameMatchScorestring
  Description
  metrix used for name matching logic.
- addressMatchScorestring
  Description
  metrix used for name matching logic.
- verificationsobject
  Description
  element level verification returned as true or false [Only applicable elements will be included, and not all elements may be present]
  - addressElement1boolean
  - addressElement3boolean
  - addressElement4boolean
  - addressElement5boolean
  - dateOfBirthboolean
  - firstNameboolean
  - landlineNumberboolean
  - lastNameboolean
  - middleNameboolean
  - mobileNumberboolean
- returnedDataobject
  Description
  returns additional data from the data source.
  - sourcestring
    Description
    identifies the data source used
remarksarray
Description
will return remarks regarding any encountered issues or pre-validation errors.

curl

curl --location 'https://idu-test.datazoo.com/api/v2/verify' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ0ZXN0IiwiaWF0IjoxNzQxNTY0NTUwLCJpcGEiOiIzNC4xNTEuMTE3LjI0OSIsInVpZCI6MzAzLCJvaWQiOjYyLCJsaWQiOjU1MzA5MTgsImV4cCI6MTc0MTU5MzM1MCwiYXVkIjoiaHR0cHM6Ly9pZHUuZGF0YXpvby5jb20ifQ.Dk7sBvIL8xho20_QBvRqS36zvWJI4FDWxUzOQdEMEspAM4HiYAnRZ1A39eNbhuuOh_479AgA0llrXFvMzS0DNw' \
--data '{
    "countryCode": "AU",
    "service": [
        "Australia Residential Lookup"
    ],
    "clientReference": "Test_0001",
    "firstName": "Aloysius",
    "middleName": "Jefferson",
    "lastName": "Pasco",
    "dateOfBirth": "1946-11-01", 
    "addressElement1": "30 Plane Tree Green", 
    "addressElement3": "Forrestfield", 
    "addressElement4": "WA", 
    "addressElement5": "6058", 
    "identityVariables": {
        "phoneNo": "0487787402" 
        
    }
}'

200

{
    "countryCode": "Australia",
    "clientReference": "Test_0001",
    "reportingReference": "DZ-7905e55c-0ebf-4857-9958-878642e720bc",
    "matchStatus": "Full Match 1+1 Verification",
    "searchErrorMessage": "",
    "safeHarbour": false,
    "searchStatus": "Successful",
    "serviceResponses": {
        "Australia Residential Lookup": {
            "status": 1,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": true,
            "safeHarbourScore": "N/A",
            "nameMatchScore": "A1",
            "addressMatchScore": "0",
            "verifications": {
                "addressElement1": true,
                "addressElement3": true,
                "addressElement4": true,
                "addressElement5": true,
                "dateOfBirth": true,
                "firstName": true,
                "landlineNumber": false,
                "lastName": true,
                "middleName": false,
                "mobileNumber": true
            },
            "returnedData": {
                "source": "DZ1"
            }
        }
    },
    "remarks": []
}

Links

About Safe Harbour Scores

Change History

Added

Last updated - 10 March, 2025