Validate International Bank Account Numbers from 40+ countries using ISO 13616 MOD-97. Returns structure breakdown, bank lookup, and detailed error codes.
curl "https://bankcheck.dev/api/v1/validate?q=GB29NWBK60161331926819"{
"apiVersion": "1",
"processingTimeMs": 1,
"result": {
"valid": true,
"format": "iban",
"normalized": "GB29NWBK60161331926819",
"errors": [],
"breakdown": {
"formatName": "IBAN",
"parts": [
{ "label": "Country", "value": "GB", "start": 0, "end": 2 },
{ "label": "Check Digits", "value": "29", "start": 2, "end": 4 },
{ "label": "Bank Code", "value": "NWBK", "start": 4, "end": 8 },
{ "label": "Sort Code", "value": "601613", "start": 8, "end": 14 },
{ "label": "Account Number", "value": "31926819", "start": 14, "end": 22 }
]
},
"bankInfo": {
"bankName": "NatWest",
"bic": "NWBKGB2L",
"country": "United Kingdom",
"countryCode": "GB",
"city": "London"
}
}
}curl "https://bankcheck.dev/api/v1/validate?q=DE00370400440532013000"{
"apiVersion": "1",
"processingTimeMs": 0,
"result": {
"valid": false,
"format": "iban",
"normalized": "DE00370400440532013000",
"errors": [
{
"code": "CHECKSUM_FAILED",
"message": "IBAN check digits are incorrect",
"suggestion": "Double-check digits 3-4 of the IBAN"
}
],
"breakdown": null,
"bankInfo": null
}
}When validation succeeds, result.breakdown.parts contains the labeled structure of the IBAN.
| Field | Type | Description |
|---|---|---|
| Country | string | ISO 3166-1 alpha-2 country code (e.g. DE, GB, FR) |
| Check Digits | string | 2-digit MOD-97 check digits (positions 3-4) |
| Bank Code | string | Bank identifier — format varies by country (BLZ, sort code, BIC prefix, etc.) |
| Account Number | string | Domestic account number — length and format vary by country |
| Field | Type | Description |
|---|---|---|
| UNKNOWN_COUNTRY | error | The 2-letter country code is not recognized as an IBAN-issuing country |
| WRONG_LENGTH | error | The IBAN length does not match the expected length for the country |
| INVALID_BBAN_FORMAT | error | The BBAN portion does not match the country's expected pattern |
| CHECKSUM_FAILED | error | The MOD-97 check digit verification failed |
The API validates IBANs from 77 countries including Germany, United Kingdom, France, Spain, Italy, Netherlands, Belgium, Austria, Switzerland, Poland, and more. Each country has specific length and BBAN format rules. See the IBAN validator for the full country list.
Back to API Docs.