Germany Utility

3 min

Verifies input data against commercial and telco data obtained from the partnered sources from Germany.

For Authorization Get Session Token from Authentication page.

Germany Utility

* Verification Outcome – Returns KYC verification * Consumer Consent – N/A * Mandatory Input – Name * Verifies – Name, DOB and Address * Returned Data - N/A

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
  DE
- servicearrayrequired
  Description
  Germany 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
- addressElement1string
  Description
  the house/unit number and street name of the address
- addressElement3string
  Description
  the Town/City of the address
- addressElement4string
  Description
  the Province of the address
- addressElement5string
  Description
  the post code of the address

Response

countryCodestring
Description
Germany
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 "Germany Utility" 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
  "1.000" - matched "0.000" - no match
- 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
  - lastNameboolean
- returnedDataobject
  Description
  Null
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.eyJpc3MiOiJ0ZXN0IiwiaWF0IjoxNzQzMzgxNTg4LCJpcGEiOiIzNC4xNTEuMTE3LjI0OSIsInVpZCI6MzAzLCJvaWQiOjYyLCJsaWQiOjU2NTc5MDQsImV4cCI6MTc0MzQxMDM4OCwiYXVkIjoiaHR0cHM6Ly9pZHUuZGF0YXpvby5jb20ifQ.5ed7HLedBmdXwwincXQPyCU3Suxg7bkHljLruwIpYlNxwz3873KjBmC2Dwy5VkGOTc9qAsp6HymAPXfMcMO2KA' \
--data '{
    "countryCode": "DE",
    "service": [
        "Germany Utility"
    ],
    "clientReference": "Test_0001",
    "firstName": "Patricia", 
    "lastName": "Fritzsche", 
    "dateOfBirth": "1984-06-06", 
    "addressElement1": "66c MusterStr. Bei Schulze", 
    "addressElement3": "Musterhausen", 
    "addressElement4": "Deutschland", 
    "addressElement5": "20095"
}'

200

{
    "countryCode": "Germany",
    "clientReference": "Test_0001",
    "reportingReference": "DZ-7c3d8286-c255-4a22-a383-bfb8a6aeec63",
    "matchStatus": "Full Match 1+1 Verification",
    "searchErrorMessage": "",
    "safeHarbour": false,
    "searchStatus": "Successful",
    "serviceResponses": {
        "Germany Utility": {
            "status": 1,
            "sourceStatus": "Successful",
            "errorMessage": "",
            "identityVerified": true,
            "safeHarbourScore": "M2",
            "nameMatchScore": "1.000",
            "addressMatchScore": "0.000",
            "verifications": {
                "addressElement1": false,
                "addressElement3": false,
                "addressElement5": false,
                "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 - 31 March, 2025