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 Name | Type | Length | Optional/Mandatory | Notes |
---|---|---|---|---|
Forename | String | 15 | Mandatory | |
MiddleNames | String | 15 | Optional | |
Surname | String | 30 | Mandatory | |
Gender | String | Optional | Must be 'M' or 'F' if provided | |
DayOfBirth | Integer | 2 | Mandatory | |
MonthOfBirth | Integer | 2 | Mandatory | |
YearOfBirth | Integer | 4 | Mandatory | |
HouseName | String | 26 | Mandatory if no HouseNumber given | |
HouseNumber | String | 26 | Mandatory if no HouseName given | |
Street | String | 40 | Mandatory | |
County | String | 20 | Optional | |
City | String | 20 | Mandatory | |
Postcode | String | 8 | Mandatory | |
Phone Number | String | 16 | Optional | Please 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:
"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
"options": {
"sandbox": "true"
}
Sandbox Cases
Pass result
If the following details are set, a single fictitious PASS result is returned in IDCheckNLAlphaResult
Property | Value |
---|---|
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:
Property | Value |
---|---|
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
Property | Value |
---|---|
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:
Property | Value |
---|---|
HaltTriggered: | False |
ServiceInterpretResult: | Fail |
ServiceTransactionResult: | Success |
ServiceTransactionResultMessage: | "This call was generated using sandbox mode" |
ValidationResult: | Pass |