Documentation
IBANcheck Nationaal
Ensure correctly entered bank account details and avoid payment failures or additional bank charges.
IBAN is the International Bank Account Number. The IBAN is a way of showing your existing bank account details in an internationally recognized and standardized format
It is made up of 4 elements:
- Country code: 2 characters to describe the country
- Check digit: 2 digits are used to check the validate of the IBAN.
- Bank code: Up to 4 characters to describe the bank name.
- Account number: Up to 10 alphanumeric characters starting with a zero.
We offer 2 APIs within IBANcheck Nationaal product. Either validate a complete IBAN code or turn an (old existing) bank account number into a complete IBAN code:
| Method | Description |
| https://api.postnl.nl/iban/national/v1/validate | API that validates a complete IBAN code. |
| https://api.postnl.nl/iban/national/v1/calculate | API that turns a bank account number in a complete IBAN by adding a country code, bank code and check digit. |
Note: This API supports the GET method.
Preview the API call buildup below.
Request Calculate
| Attribute | Mandatory | Format | Description | Example |
| account | M | String [10] Either with or without the first character ‘0’. Within the IBAN code a bank account number starts with a ‘0’. | Account number | 0123456789 |
Response Calculate
| Attribute | Description | Example |
| iban | IBAN code | NL24BANK0123456789 |
| address | Address of the bank | Teststreet 100 |
| bank | Bank name | Rabobank |
| bic | Bank Identifier Code | BANKNL2XXXX |
| city | City of the bank | Amsterdam |
| zip | Postalcode of the bank | 1000 AA |
Status codes Calculate
The following status codes can be returned for the calculation API:
| Attribute | Format |
| I01 | Invalid account number |
| I03 | Bank code not found |
Request Validate
| Attribute group | Mandatory | Description | Example |
| iban | M | IBAN code | NL24BANK0123456789 |
Response Validate:
| Attribute group | Attribute | Description | Example |
| bank_data | bic | Bank Identifier Code | BANKNL2AXXX |
| bank | Bank name | BANK NEDERLAND | |
| address | Address of the bank | GELDSTRAAT 18 | |
| city | City of the bank | AMSTERADM | |
| zip | ZIP of the bank | 1000 AA | |
| country | Country of the bank of the bank | Netherlands | |
| country_iso | Country ISO of the bank | NL | |
| account | Account number | 0123456789 | |
| errors | code | Status codes (up to 5 in the output) | I01 |
The following status codes can be returned for the validation API:
| Status Code | Type | Description |
| C01 | Correct | Check digit correct |
| C02 | Correct | Check digit account number correct |
| C03 | Correct | Length correct |
| C04 | Correct | Check digit not supported by account number |
| C05 | Correct | Structure correct |
| I01 | Incorrect | Check digit account number incorrect |
| I02 | Incorrect | Check digit incorrect |
| I03 | Incorrect | Length incorrect |
| I04 | Incorrect | Structure incorrect |
I05 | Incorrect | Only dutch (NL) account numbers allowed |
| E01 | Error | Invalid API Key |
E02 | Error | Account error |
| E03 | Error | No queries available |
| E04 | Error | Access denied |