RiskCheckThis 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. |
riskCheckPersonReturns 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| 1 | initials, name, postcode, house number | | 2 | initials, name, birth date | | 3 | postcode, house number, birth date | | 4 | account number, birth date | | 5 | phone number, birth date | | 6 | mobile number, birth date | | 7 | email, 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| gender | Gender of the person. M or F, may be empty. | | initials | The initials, mandatory. | | prefix | The surname prefix, like “van” or “de”, may be empty. | | last_name | The last name of the person, mandatory. | | birth_date | Birth date in the format yyyy-mm-dd, may be empty. | | street | Street part of the address, may be empty. | | house_number | House number, mandatory. | | house_number_addition | Extension part of the house number, may be empty. | | postcode | Dutch postcode in the format 1234AB, mandatory. | | city | City, may be empty. | | account_number | Bank account number, only numeric characters, may be empty. | | phone_number | Home phone number, only numeric characters (e.g. 0201234567), may be empty. | | mobile_number | Mobile phone number, only numeric characters (e.g. 0612345678), may be empty. | | email | Email address, may be empty. | | testing_date | Date for which the credit score should be determined, in the format yyyy-mm-dd, mandatory. |
Returns
RiskResultCreditworthiness 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_score | Score indicating the creditworthiness of the person. Highest score of all registrations for this person in the past 5 years. | | address_score | Score indicating the creditworthiness of the address. Highest score of all registrations for this address in the past year. | | postcode_score | The 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. |
|