RiskCheck

This service provides creditworthiness scores for a person, address and postcode area.

Summary
This service provides creditworthiness scores for a person, address and postcode area.
Returns a score indicating creditworthiness for a Dutch person, address and postcode area.
Creditworthiness score of a person, address and postcode area.

Service methods

riskCheckPerson

Returns a score indicating creditworthiness for a Dutch person, address and postcode area.  The given parameters are used to search for a person.

The following fields are tried in the order listed, until a matching person is found

1initials, name, postcode, house number
2initials, name, birth date
3postcode, house number, birth date
4account number, birth date
5phone number, birth date
6mobile number, birth date
7email, birth date

For instance, if initials, postcode, house number and birth date are specified and a match is found on the fields listed under 1, birth date will be ignored.

Scores for address and postcode are determined independent of the person details.

Search fields are case-insensitive.  Non-ASCII characters are mapped to the corresponding character without diacritical mark (e.g. an accented e is mapped to an ‘e’).

Parameters

genderGender of the person.  M or F, may be empty.
initialsThe initials, mandatory.
prefixThe surname prefix, like “van” or “de”, may be empty.
last_nameThe last name of the person, mandatory.
birth_dateBirth date in the format yyyy-mm-dd, may be empty.
streetStreet part of the address, may be empty.
house_numberHouse number, mandatory.
house_number_additionExtension part of the house number, may be empty.
postcodeDutch postcode in the format 1234AB, mandatory.
cityCity, may be empty.
account_numberBank account number, only numeric characters, may be empty.
phone_numberHome phone number, only numeric characters (e.g.  0201234567), may be empty.
mobile_numberMobile phone number, only numeric characters (e.g.  0612345678), may be empty.
emailEmail address, may be empty.
testing_dateDate for which the credit score should be determined, in the format yyyy-mm-dd, mandatory.

Returns

outA RiskResult entry

Type definitions

RiskResult

Creditworthiness score of a person, address and postcode area.  Scores range from 0 to 11, where higher scores indicate higher risks.

A score of 0 means that the person has no registrations in the collections or bankruptcy database, a score of 1 means that the worst registration on that person is a fully paid collection claim without bailiff, ..., a score of 10 means that the worst registration on that person is a fully written-off collection claim with bailiff, and a score of 11 means that the person has a registration in the bankruptcy database.

For further explanation of scores (in Dutch), see: https://webview.webservices.nl- /documentation- /images- /riskcheck_scores.png

person_scoreScore indicating the creditworthiness of the person.  Highest score of all registrations for this person in the past 5 years.
address_scoreScore indicating the creditworthiness of the address.  Highest score of all registrations for this address in the past year.
postcode_scoreThe score on postcode represents the average address score of all addresses with that postcode, where the address score is based on registrations of at most 5 years ago.
Creditworthiness score of a person, address and postcode area.