Skip to content
On this page

Id Check NL Alpha

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

The following request properties pertain to this service.

Property NameTypeLengthOptional/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

The following is an example response:

json
"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

Query options for Sandbox

json
"options": {
	"sandbox": "true"
}

Sandbox Cases

Pass result

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

PropertyValue
City:"Stein"
DayOfBirth:14
Forename:"Michael"
HouseNumber:241
MonthOfBirth:7
PhoneNumber:"0619154863"
Postcode:"6171KK"
Street:"Stadhouderslaan"
Surname:"Meuleberg"
YearOfBirth:1975

The corresponding entry in ServiceTransactions will show the following properties:

PropertyValue
HaltTriggered:False
ServiceInterpretResult:NotApplicable
ServiceTransactionResult:Success
ServiceTransactionResultMessage:"This call was generated using sandbox mode"
ValidationResult:Pass

Fail result

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

PropertyValue
City:"Hague"
DayOfBirth:12
Forename:"Thomas"
HouseNumber:61
MonthOfBirth:5
Postcode:"2522HK"
Street:"Boele van Hensbroekstraat"
Surname:"Duisenberg"
YearOfBirth:1981

The corresponding entry in ServiceTransactions will show the following properties:

PropertyValue
HaltTriggered:False
ServiceInterpretResult:Fail
ServiceTransactionResult:Success
ServiceTransactionResultMessage:"This call was generated using sandbox mode"
ValidationResult:Pass