Composite Searching

3 min

Composite search in Greece enables clients to automate the selection of multiple services, processing verification inputs through successive data sources and returning responses from each selected service.

Example - API Requests and Responses with following services configured:

Greece Credit Bureau Greece Consumer

Greece Composite Search

* Verification Outcome – KYC verification from sequenced searching and returns single or duel (where possible) source matches * Consumer Consent – N/A * Mandatory Input – Name and DOB * Verifies – Name, DOB, Address, Phone and Tax ID number * Returned Data - The match score for each name and/or address element (if configured)

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
  GR
- servicearrayrequired
  Description
  Greece Credit Bureau
- clientReferencestring
  Description
  a client reference field
- firstNamestringrequired
  Description
  first name 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
- 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
  - stringrequired
- identityVariablesobject
  Description
  other elements for verification
  - taxIDNostring
    Description
    Tax Identification number of the identity owner
  - phoneNostring
    Description
    phone number of the identity owner

Response

countryCodestring
Description
Greece
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
  - emailAddressboolean
  - firstNameboolean
  - lastNameboolean
  - phoneNoboolean
- returnedDataobject
  Description
  * refer to the section at the bottom of the page titled "Service Responses Overview"
  - altAddressMatchScoreobject
    Description
    * the match score for each address element (if configured)
    - addressElement1string
    - addressElement3string
    - addressElement4string
    - addressElement5boolean
  - altNameMatchScoreobject
    Description
    * the match score for each name element (if configured)
    - firstNamestring
    - lastNamestring
    - middleNamestring
remarksarray
Description
Null

curl

curl --location 'https://idu-test.datazoo.com/api/v2/verify' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ0ZXN0IiwiaWF0IjoxNzQzNDYyNDQ4LCJpcGEiOiIzNC4xNTEuMTE3LjI0OSIsInVpZCI6MzAzLCJvaWQiOjYyLCJsaWQiOjU2NjQ2MTUsImV4cCI6MTc0MzQ5MTI0OCwiYXVkIjoiaHR0cHM6Ly9pZHUuZGF0YXpvby5jb20ifQ.D_mGA78PBG_p_wYy-JcKCy28Rk8CX_U0IADn8DeEL8aSw3cnusbiDefJIqE_j74QcKu0IXNNpE-9SoQUSL8fAg' \
--data '{
    "countryCode": "GR",
    "service": [
        "Greece Credit Bureau",
        "Greece Consumer"
    ],
    "clientReference": "Test_0001",
    "firstName": "CLFNAME", 
    "middleName": "CLMNAME",
    "lastName": "CLLNAME", 
    "gender": "Female",
    "dateOfBirth": "1995-08-01", 
    "addressElement1": "CLADDRESS 1",
    "addressElement3": "CLCITY", 
    "addressElement4": "CLSTATE",
    "addressElement5": "99999",
    "identityVariables": {
        "taxIDNo": "888888888", 
        "phoneNo": "8888888888"
    }
}'

200

{
    "countryCode": "Greece",
    "clientReference": "Test_0001",
    "reportingReference": "DZ-5cf7741a-12bd-424a-9a0c-18cbb1bf5814",
    "matchStatus": "Full Match 1+1 Verification",
    "searchErrorMessage": "",
    "safeHarbour": false,
    "searchStatus": "Successful",
    "serviceResponses": {
        "Greece Consumer": {
            "status": 2,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": false,
            "safeHarbourScore": "none",
            "nameMatchScore": "0.000",
            "addressMatchScore": "0.000",
            "verifications": {
                "addressElement1": false,
                "addressElement3": false,
                "addressElement5": false,
                "dateOfBirth": false,
                "firstName": false,
                "lastName": false,
                "phoneNo": false
            },
            "returnedData": {}
        },
        "Greece Credit Bureau": {
            "status": 1,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": true,
            "safeHarbourScore": "M1",
            "nameMatchScore": "1.000",
            "addressMatchScore": "0.900",
            "verifications": {
                "addressElement1": true,
                "addressElement3": true,
                "addressElement4": true,
                "addressElement5": true,
                "dateOfBirth": true,
                "firstName": true,
                "gender": true,
                "lastName": true,
                "middleName": true,
                "phoneNo": true,
                "taxIDNo": false
            },
            "returnedData": {}
        }
    },
    "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 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 (if applicable).

Change History

Added

Last updated - 1 April, 2025