Sequenced Searching

4 min

Sequenced searching in Australia can be configured for clients upon request.

When making sequenced calls for Australia, the API input for the service MUST be set to "Australia Residential".

Example 1 - API Requests and Responses with following four services configured:

Australia Citizens Australia Consumer Australia Credit Bureau Australia Residential

Australia Sequenced Search (example 1)

* Verification Outcome – KYC verification from sequenced searching and returns single or duel (where possible) source matches * Consumer Consent – YES (for Australia Credit Bureau) * Mandatory Input – Name, DOB, and Address * Verifies – Name, Address, DOB and other input elements given for verification * Returned Data - type of data source, service identifier and other service related data (if applicable)

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
- 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
- dateOfBirthstringrequired
  Description
  in YYYY-MM-DD (preferred) or DD-MM-YYYY format
- addressElement1stringrequired
  Description
  the street level address of the identity owner
- addressElement3stringrequired
  Description
  the suburb address of the identity owner
- addressElement4stringrequired
  Description
  the state address of the identity owner
- addressElement5stringrequired
  Description
  the postcode of the address of the identity owner
- identityVariablesobject
  Description
  other elements for verification
  - phoneNostring
    Description
    phone number of the identity owner
  - emailstring
    Description
    email address of the identity owner
- consentObtainedobjectrequired
  Description
  consent given by the identity owner
  - Australia Credit Bureaubooleanrequired
    Description
    should be true

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" "Full Match 2+2 Verification" "No Match"
searchErrorMessagestring
Description
error message returned querying the data source
safeHarbourboolean
Description
true or false
searchStatusstring
Description
"Successful" "Not Successful"
serviceResponsesobject
Description
* refer to the section at the bottom of the page titled "Service Responses Overview"
- 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
  * refer to the section at the bottom of the page titled "Service Responses Overview" * For more information, refer to Safe Harbour Scores page
- nameMatchScorestring
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
- addressMatchScorestring
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
- verificationsobject
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
  - addressElement1boolean
  - addressElement3boolean
  - addressElement4boolean
  - addressElement5boolean
  - dateOfBirthboolean
  - emailboolean
  - firstNameboolean
  - landlineNoboolean
  - lastNameboolean
  - middleNameboolean
  - phoneNoboolean
- returnedDataobject
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
  - categorystring
    Description
    data source type or category (example, telco, consumer etc)
  - 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.eyJpc3MiOiJ0ZXN0IiwiaWF0IjoxNzQyNzgyMDQyLCJpcGEiOiIzNC4xNTEuMTE3LjI0OSIsInVpZCI6MzAzLCJvaWQiOjYyLCJsaWQiOjU2MTA0OTEsImV4cCI6MTc0MjgxMDg0MiwiYXVkIjoiaHR0cHM6Ly9pZHUuZGF0YXpvby5jb20ifQ.PiwAcFHRsl0cV7cH5LYMxKHv01cr7RSwB9WJbGthGVgR_ikB0Q2HWFMY64MweKHF_oU1DpzqTsUG4iVR-yIHgQ' \
--data-raw '{
    "countryCode": "AU",
    "service": [
        "Australia Residential"
    ],
    "clientReference": "TestSequencing_0001",
    "firstName": "Grant",
    "middleName": "Eric",
    "lastName": "Brook",
    "dateOfBirth": "1973-10-24",
    "addressElement1": "52 HAPPYVALLY RD",
    "addressElement3": "IRONBARK",
    "addressElement4": "VIC",
    "addressElement5": "3551",
    "consentObtained": {
        "Australia Credit Bureau": true
    },
    "identityVariables": {
        "phoneNo": "0411111111",
        "email": "[email protected]"
    }
}
'

200

{
    "countryCode": "Australia",
    "clientReference": "TestSequencing_0001",
    "reportingReference": "DZ-bfc3d6d1-7c90-4e14-83d9-f7a42b786132",
    "matchStatus": "Full Match 1+1 Verification",
    "searchErrorMessage": "",
    "safeHarbour": false,
    "searchStatus": "Successful",
    "serviceResponses": {
        "Australia Credit Bureau": {
            "status": 0,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": true,
            "safeHarbourScore": "M1",
            "nameMatchScore": "1.000",
            "addressMatchScore": "1.000",
            "verifications": {
                "addressElement1": true,
                "addressElement3": true,
                "addressElement4": true,
                "addressElement5": true,
                "dateOfBirth": true,
                "firstName": true,
                "lastName": true,
                "middleName": true
            },
            "returnedData": {
                "category": "credit",
                "source": "dz2"
            }
        }
    },
    "remarks": []
}

404

{
  "message": "Ain't no cake like that."
}

Example 2 - API Requests and Responses with following four services configured:

Australia Passport Australia Medicare Card Australia Citizens Australia Consumer

Australia Sequenced Search (example 2)

* Verification Outcome – KYC verification from sequenced searching and returns single or duel (where possible) source matches * Consumer Consent – YES (for Australia Passport, Australia Driver Licence and Australia Medicare Card) * Mandatory Input – Name and Address * Verifies – Name, Address, DOB and other input elements given for verification * Returned Data - type of data source, service identifier and other service related data (if applicable)

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
- 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
- genderstring
  Description
  Male or Female
- dateOfBirthstringrequired
  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
  - passportNostring
    Description
    phone number of the identity owner
  - medicareCardTypestringrequired
  - medicareExpirystringrequired
  - medicareCardNostringrequired
  - medicareReferenceNointegerrequired
  - phoneNostring
  - emailstring
  - medicareNameLine1string
  - medicareNameLine2string
  - medicareNameLine3string
  - medicareNameLine4string
- consentObtainedobjectrequired
  Description
  consent given by the identity owner
  - Australia Passportbooleanrequired
    Description
    should be true
  - Australia Medicare Cardbooleanrequired

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" "Full Match 2+2 Verification" "No Match"
searchErrorMessagestring
Description
"" error message returned querying the data source
safeHarbourboolean
Description
true or false
searchStatusstring
Description
"Successful" "Unsuccessful"
serviceResponsesobject
Description
* refer to the section at the bottom of the page titled "Service Responses Overview"
- 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
  * refer to the section at the bottom of the page titled "Service Responses Overview" * For more information, refer to Safe Harbour Scores page
- nameMatchScorestring
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
- addressMatchScorestring
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
- verificationsobject
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
  - addressElement1boolean
  - addressElement3boolean
  - addressElement4boolean
  - addressElement5boolean
  - dateOfBirthboolean
  - documentNoboolean
  - emailboolean
  - firstNameboolean
  - landlineNoboolean
  - lastNameboolean
  - middleNameboolean
  - phoneNoboolean
- returnedDataobject
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
  - categorystring
    Description
    data source type or category (example, telco, consumer etc)
  - 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 eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImMtbVZlMl9KRFhMcnkzaEhQWEN4TyJ9.eyJ1aWQiOiIzMDMiLCJvaWQiOiI2MiIsImlzcyI6Imh0dHBzOi8vZGF0YXpvby10ZXN0LnVzLmF1dGgwLmNvbS8iLCJzdWIiOiJhdXRoMHwzMDMiLCJhdWQiOiJodHRwczovL2t5Yy10ZXN0LmRhdGF6b28uY29tIiwiaWF0IjoxNzQ4ODIwMTM2LCJleHAiOjE3NDg4NTYxMzYsImd0eSI6InBhc3N3b3JkIiwiYXpwIjoiSWxVdURJNTF1QXpuVnE2VGVoRXAyOXBrbEhBSjFtYnkifQ.OsFI7E0ICd3SDqxgNZkjrAxhPcifuwedNOahFmQPJPKrJyeqOAOwjXkw2izZt6t1Cj5VrKIkOjNe8vBphbOrvFtA73FQGnk_EGiMpzUsGKo_OOgmFoqTSbSNphuM2MLlAGXK0x78-YGtsOVZciyCdlDNM8wMoSvg_vFxwBe2-OOV9ICNcsD6VRdx21FP2K5bvpdLHlfHzeXJmeB7rOBnrJ7gro0ThTfqPbR-gf77nkTXHPdloLYO9L0vDTKAGQl6PCWc-5sg64-jk2tpXg85-p7qmy4zCyibQHzmN1OT4xcrkDQ4xKCDjJ_NHlOysnTO_Bq1GOrwskcaGdPoxAw2LA' \
--data-raw '{
    "countryCode": "AU",
    "service": [
        "Australia Residential"
    ],
    "clientReference": "TestSandboxSequencing_0001",
    "firstName": "Jane",
    "middleName": "",
    "lastName": "Citizen",
    "dateOfBirth": "1984-07-06",
    "addressElement1": "52 HAPPYVALLY RD",
    "addressElement3": "IRONBARK",
    "addressElement4": "VIC",
    "addressElement5": "3551",
    "consentObtained": {
        "Australia Passport": true,
        "Australia Medicare Card": true     
    },
    "identityVariables": {
        "passportNo": "PA0940443",
        "medicareCardType": "G", 
        "medicareExpiry": "2022-12-01", 
        "medicareCardNo": "3512743581", 
        "medicareReferenceNo": 1, 
        "medicareNameLine1": "Jane Citizen",         
        "phoneNo": "0411111111",
        "email": "[email protected]"
    }
}
'

200

{
    "countryCode": "Australia",
    "clientReference": "TestSandboxSequencing_0001",
    "reportingReference": "DZ-df105596-93a1-454c-a83b-f8d36bbe5c66",
    "matchStatus": "Full Match 2+2 Verification",
    "searchErrorMessage": "",
    "safeHarbour": true,
    "searchStatus": "Successful",
    "serviceResponses": {
        "Australia Government Identity Documents 2": {
            "status": 0,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": true,
            "safeHarbourScore": "L2",
            "nameMatchScore": "1.000",
            "addressMatchScore": "N/A",
            "verifications": {
                "dateOfBirth": true,
                "documentNo": true,
                "firstName": true,
                "lastName": true
            },
            "returnedData": {
                "category": "government",
                "source": "dz8"
            }
        },
        "Australia Government Identity Documents 3": {
            "status": 0,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": true,
            "safeHarbourScore": "L2",
            "nameMatchScore": "1.000",
            "addressMatchScore": "N/A",
            "verifications": {
                "dateOfBirth": true,
                "documentNo": true,
                "fullName": true
            },
            "returnedData": {
                "category": "government",
                "source": "dz9"
            }
        }
    },
    "remarks": []
}

404

{
  "message": "Ain't no cake like that."
}

Service Responses Overview

Each service returns its own self-contained response block, ensuring modular and source-specific verification results. Consumers of this API should handle varying response structures dynamically based on the requested services.

Service Responses Element

The serviceResponses object in the API response contains verification results from one or more data sources, structured under their respective service names. Each service (e.g., "Australia Consumer", "Australia Credit Bureau" from Example 1) returns a distinct response block with service-specific data.

Structure and Behavior:

Each key within serviceResponses corresponds to a service name, representing an individual verification source.
Services may return data from a single source or multiple sources in a sequenced API call.
The structure of each service response varies, with fields such as status, identityVerified, and safeHarbourScore differing between services.
The verifications block contains service-specific boolean indicators for individual verification checks (e.g., addressElement1, dateOfBirth, firstName).
The returnedData block provides metadata, including category and source, indicating the data provider used for verification.

Change History

Added

2025-10-03: inclusion of "medicareNameLine#" field

Added

Last updated - 24 March, 2025