Greece Utility

3 min

Verifies input data against Utility data obtained from the partnered sources from Greece.

For Authorization Get Session Token from Authentication page.

Greece Utility

Multilingual input -- Both English and Greek script are supported as input for the name and address fields. Numbers should be given in English digits. Example: "Ραιδεστού 111" as the street level address input. * Verification Outcome – Returns KYC verification * Consumer Consent – N/A * Mandatory Input – Name, Street and Post Code * Verifies – Name, DOB, Address * 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 Utility
- clientReferencestring
  Description
  a client reference field
- firstNamestringrequired
  Description
  the first name 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
- addressElement1stringrequired
  Description
  the house/unit number and street name of the address
- addressElement3string
  Description
  the Town/City of the address
- addressElement5stringrequired
  Description
  the post code of the address

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" "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 "Greece Credit Bureau" 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
  M1, M2, N1 or "none" * For more information, refer to Safe Harbour Scores page
- nameMatchScorestring
  Description
  A string that acts as a value between 0.000 and 1.000.
- addressMatchScorestring
  Description
  A string that acts as a value between 0.000 and 1.000.
- 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
  - addressElement5boolean
  - dateOfBirthboolean
  - firstNameboolean
  - genderboolean
  - lastNameboolean
  - middleNameboolean
  - phoneNoboolean
  - taxIDNoboolean
- returnedDataobject
  Description
  returns additional data from the data source.
  - altAddressMatchScoreobject
    Description
    the match score for each address element (if configured)
    - addressElement1string
    - addressElement3string
    - addressElement4string
    - addressElement5string
  - altNameMatchScoreobject
    Description
    the match score for each name element (if configured)
    - firstNamestring
    - lastNamestring
    - middleNamestring
remarksarray
Description
will return remarks regarding any encountered issues.

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 Utility"
    ],
    "clientReference": "Test-01",
    "firstName": "Κοτρατσιιοσ", //Kotratsios
    "lastName": "Πετροσ", //Petros
    "dateOfBirth": "1985-02-09",
    "addressElement1": "Papagou 3",
    "addressElement3": "ΑΡΝΑΙΑ",
    "addressElement5": "63074"
}'

200

{
    "countryCode": "GR",
    "clientReference": "EG-01",
    "reportingReference": "DZ-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "matchStatus": "Full Match 1+1 Verification",
    "searchErrorMessage": "",
    "safeHarbour": false,
    "searchStatus": "Successful",
    "serviceResponses": {
        "Greece Utility": {
            "status": 1,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": true,
            "safeHarbourScore": "M1",
            "nameMatchScore": "1.000",
            "addressMatchScore": "1.000",
            "verifications": {
                "addressElement1": true,
                "addressElement3": true,
                "addressElement5": true,
                "dateOfBirth": true,
                "firstName": true,
                "lastName": true,
            },
            "returnedData": {}
        }
    },
    "remarks": []

404

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

Links

About Safe Harbour Scores

Change History

Added

Last updated - 1 April, 2025