Germany KYC

Overview

The Germany KYC Check API for Germany provides an automated way to verify the personal and residential details of DE citizens. This API is designed to confirm the accuracy of provided information against authoritative databases, aiding in identity verification and compliance with regulatory standards.

Usecase

This API is particularly valuable for:

Financial Services: Banks and other financial institutions can use this API to verify identity details during account opening, loan applications, or customer record updates.

Employment Background Checks: Companies performing pre-employment screening can verify the personal details of potential hires.

Government Services: Government agencies can verify citizen details for program eligibility or document issuance.

API Details

Request Body

curl --location 'https://api.signzy.app/api/v3/global-kyc/verify/de' \
--header 'Authorization: <----Auth Token---->' \
--header 'Content-Type: application/json' \
--data-raw '{
   "firstName": "Tobias",
    "lastName": "Gottliaeb",
    "dateOfBirth": "1932-01-14",
    "addressElement1": "Sonnentalwseg 18",  
    "addressElement3": "Wasserbad",  
    "addressElement5":"23456",
    "consent" : true
}'

Request Body Parameters

Parameter	Type	Description	Required
firstName	String	First name of the individual	Yes
middleName	String	Middle name of the individual	No
lastName	String	Last name of the individual	Yes
dateOfBirth	Date	Date of birth (format: YYYY-MM-DD)	Yes
addressElement1	String	Primary residential address line	Yes
addressElement3	String	City or locality part of the address	Yes
addressElement5	String	Postal code	Yes
consent	Boolean	Consent from the individual for verification	Yes

{
    "result": {
        "verificationResult": {
            "AddressElement1": true,
            "AddressElement3": true,
            "AddressElement5": false,
            "dateOfBirth": true,
            "firstName": true,
            "lastName": true,
            "nameScore": 0.98,
            "addressScore": 0.8
        },
        "verified": true
    },
    "reason": "Request Successful",
    "code": "S001"
}

Response Body Parameter

Parameter	Type	Description
result	Object	Container holding the verification result.
result.firstName	Boolean	Result of the first name verification.
result.lastName	Boolean	Result of the last name verification.
result.dateOfBirth	Boolean	Result of the date of birth verification.
result.AddressElement1	Boolean	Result of address element 1 verification.
result.AddressElement3	Boolean	Result of address element 3 verification.
result.AddressElement5	Boolean	Result of address element 5 verification.
result.nameScore	Float	Numerical score (0–1) representing the name match quality.
result.addressScore	Float	Numerical score (0–1) representing the address match quality.
result.verified	Boolean	Indicates if the overall verification result is verified.
reason	String	Explanation of the verification result.
code	String	Status code indicating the outcome.

Error Code and Response Mapping

{
    "result": {},
    "reason": "firstName is required",
    "code": "E002"
}
---
{
    "result": {},
    "reason": "lastName is required",
    "code": "E002"
}
---
{
    "result": {},
    "reason": "dateOfBirth is required",
    "code": "E002"
}
---
{
    "result": {},
    "reason": "addressElement1 is required",
    "code": "E002"
}
---
{
    "result": {},
    "reason": "addressElement3 is required",
    "code": "E002"
}
---
{
    "result": {},
    "reason": "addressElement5 is required",
    "code": "E002"
}
---
{
    "result": {},
    "reason": "Invalid value for addressElement5 should be exactly 5 Digits, numbers only",
    "code": "E003"
}
---
{
    "result": {},
    "reason": "consent is required",
    "code": "E002"
}
---
{
    "result": {},
    "reason": "consent must be true and of boolean type",
    "code": "E003"
}

Field	Type	Description
result	object	Always an object (usually empty) in error response
reason	string	Reason for the error.
status	number	HTTP status code.
Code	string	Code representing the error scenario.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!