API Status

Netherlands (Alpha/005)

Identity Verification for Netherlands

Compatible Cases

Icon 1

About the service

ID Check NL Alpha is an identity verification service for Netherlands. It uses National Database, Telephone Directory, Passports and ID Card.

Product Code: W2-DATA-EKYC-NL-005

Does this service leave a credit search Footprint? Yes


Request

PropertyTypeLengthOptional/MandatoryNotes
ForenameString15Mandatory
MiddleNamesString15Optional
SurnameString30Mandatory
GenderStringOptionalMust be 'M' or 'F' if provided
DayOfBirthInteger2Mandatory
MonthOfBirthInteger2Mandatory
YearOfBirthInteger4Mandatory
HouseNameString26Mandatory if no HouseNumber given
HouseNumberString26Mandatory if no HouseName given
StreetString40Mandatory
CountyString20Optional
CityString20Mandatory
PostcodeString8Mandatory
Phone NumberString16OptionalPlease provide the phone number as one contiguous set of numbers with no other characters or spaces.

After performing the search, the validation result (pass, fail, etc.) will be part of the TransactionInformation returned for the service call.



Response

Example response

"idCheckNLAlphaResult": {
            "individuals": {
                "individual": {
                    "addresses": {},
                    "individualSummary": {}
                },
                "summary": {
                    "decision": "-1",
                    "decisionReasons": {
                        "decisionReasonList": [
                            {
                                "decision": "-1",
                                "element": "Individual/IndividualSummary/DateOfBirthMatch"
                            },
                            {
                                "decision": "-1",
                                "element": "Individual/IndividualSummary/NameMatch"
                            }
                        ]
                    }
                },
                "type": "Result"
            },
            "searchRef": "dd66471d-8d8d-48e2-aafa-12a6c9b4c059",
            "summary": {
                "decisionMatrix": {
                    "code": "******",
                    "decision": {
                        "outcome": "1",
                        "reason": "Individual has only matched on name no address or DOB"
                    },
                    "name": "****************",
                    "rules": {
                        "ruleList": [
                            {
                                "id": "Individuals Datablock",
                                "name": "BSO/DEU/Bespoke/Nam/NameDOB",
                                "outcome": "-1",
                                "reason": "Individual has a full match to forename surname and DOB"
                            },
                            {
                                "id": "Telephony Datablock",
                                "name": "BSO/DEU/Bespoke/NamPremPC/ID/90/NameAddress",
                                "outcome": "-1",
                                "reason": "Individual has a full match to forename surname premise postcode"
                            }
                        ]
                    }
                },
                "kycSummary": {
                    "address": {
                        "count": "4"
                    },
                    "alerts": {
                        "count": "0"
                    },
                    "dateOfBirth": {
                        "count": "3"
                    },
                    "fullNameAndAddress": {
                        "count": "0"
                    },
                    "surnameAndAddress": {
                        "count": "0"
                    }
                },
                "reportSummary": {
                    "datablocksSummary": {
                        "datablockSummaryList": [
                            {
                                "decision": "1",
                                "name": "Individuals"
                            },
                            {
                                "decision": "",
                                "name": "Telephony"
                            }
                        ]
                    }
                }
            },
            "telephony": {
                "type": "NoMatch"
            }
        }

Sandbox


Pass result

If the following details are set, a single fictitious PASS result is returned in IDCheckNLAlphaResult:

PropertyValue
City"Stein"
DayOfBirth14
Forename"Michael"
HouseNumber241
MonthOfBirth7
PhoneNumber"0619154863"
Postcode"6171KK"
Street"Stadhouderslaan"
Surname"Meuleberg"
YearOfBirth1975

The corresponding entry in ServiceTransactions will show the following properties:

PropertyValue
HaltTriggeredFalse
ServiceInterpretResultNotApplicable
ServiceTransactionResultSuccess
ServiceTransactionResultMessage"This call was generated using sandbox mode"
ValidationResultPass

Fail Result

If the following details are set, a single fictitious FAIL result is returned in IDCheckNLAlphaResult

PropertyValue
City"Hague"
DayOfBirth12
Forename"Thomas"
HouseNumber61
MonthOfBirth5
Postcode"2522HK"
Street"Boele van Hensbroekstraat"
Surname"Duisenberg"
YearOfBirth1981

The corresponding entry in ServiceTransactions will show the following properties:

PropertyValue
HaltTriggeredFalse
ServiceInterpretResultFail
ServiceTransactionResultSuccess
ServiceTransactionResultMessage"This call was generated using sandbox mode"
ValidationResultPass
Language
Authorization
Header
Click Try It! to start a request and see the response here!