IBAN check API
Check an IBAN's country, length, structure and check digits against the SWIFT IBAN registry, and say exactly what is wrong.
POST https://api.curatedapi.com/v1/calc/check/iban
- Version 1
- MCP tool
calc_check_iban - Try it in the browser
Checks an International Bank Account Number the way ISO 13616 defines it: the country code must be in the SWIFT IBAN registry, the length and the structure of the account part (BBAN) must be the ones registered for that country, and the two check digits must be the ones MOD 97-10 gives. When a check fails, the answer names it, and for a wrong check digit it gives the digits the rest of the number calls for.
Formula
move the first four characters to the end, read A as 10 … Z as 35, and the number must leave remainder 1 when divided by 97; check digits = 98 − (BBAN + country + 00) mod 97
- The number is checked by arithmetic alone. Nothing is looked up, so a valid result means the number is well formed, not that the account, company or security exists.
- 89 countries are covered, as registered in release 103 (September 2026) of the SWIFT IBAN registry.
- Check digits 00, 01 and 99 are never valid: ISO 13616 only produces 02 to 98.
- Some countries put a second, national check digit inside the account part (Belgium, France, Italy, Spain and others). Those are not checked.
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
number required |
string | The IBAN to check. Spaces, dots, hyphens and slashes are ignored, and lower-case letters are read as upper case. At most 64 characters. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
valid | boolean | Whether the IBAN passes every check. |
normalized | string | The number as it was checked: separators removed, letters in upper case. |
problem | string | What is wrong, when valid is false: CHARACTERS: a character that cannot appear in this kind of number; LENGTH: the wrong number of characters; COUNTRY: an unknown or unsupported country code; FORMAT: the right length but the wrong structure; CHECK_DIGIT: the check digit or check characters do not match the rest of the number. |
message | string | The result in a sentence, naming the rule that failed. |
country | string | The ISO 3166 country code. |
country_name | string | The country's name in the registry. |
check_digits | string | Characters 3 and 4. |
expected_check_digits | string | The check digits ISO 13616 gives the country code and BBAN. |
bban | string | The Basic Bank Account Number: everything after the check digits. |
formatted | string | The IBAN in groups of four. |
Examples
The registry's United Kingdom example
curl https://api.curatedapi.com/v1/calc/check/iban \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"number": "GB29 NWBK 6016 1331 9268 19"
}'
{
"calculator": "check/iban@1",
"result": {
"valid": true,
"normalized": "GB29NWBK60161331926819",
"message": "A well-formed IBAN from United Kingdom.",
"country": "GB",
"country_name": "United Kingdom",
"check_digits": "29",
"expected_check_digits": "29",
"bban": "NWBK60161331926819",
"formatted": "GB29 NWBK 6016 1331 9268 19"
},
"exactness": {},
"precision": null,
"inputs": {
"number": "GB29 NWBK 6016 1331 9268 19"
},
"formula": "move the first four characters to the end, read A as 10 … Z as 35, and the number must leave remainder 1 when divided by 97; check digits = 98 − (BBAN + country + 00) mod 97",
"references": [
{
"title": "SWIFT IBAN Registry, release 103 (September 2026) (ISO 13616)",
"url": "https://www.swift.com/resource/iban-registry-pdf"
},
{
"title": "ISO 13616-1:2020 Financial services: International bank account number (IBAN)",
"url": "https://www.iso.org/standard/81090.html"
}
],
"warnings": []
}
A mistyped digit
curl https://api.curatedapi.com/v1/calc/check/iban \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"number": "DE89 3704 0044 0532 0130 01"
}'
{
"calculator": "check/iban@1",
"result": {
"valid": false,
"normalized": "DE89370400440532013001",
"problem": "CHECK_DIGIT",
"message": "The check digits are 89, but this country code and account number give 62 (ISO 13616, MOD 97-10). One or more characters are wrong.",
"country": "DE",
"country_name": "Germany",
"check_digits": "89",
"expected_check_digits": "62",
"bban": "370400440532013001",
"formatted": "DE89 3704 0044 0532 0130 01"
},
"exactness": {},
"precision": null,
"inputs": {
"number": "DE89 3704 0044 0532 0130 01"
},
"formula": "move the first four characters to the end, read A as 10 … Z as 35, and the number must leave remainder 1 when divided by 97; check digits = 98 − (BBAN + country + 00) mod 97",
"references": [
{
"title": "SWIFT IBAN Registry, release 103 (September 2026) (ISO 13616)",
"url": "https://www.swift.com/resource/iban-registry-pdf"
},
{
"title": "ISO 13616-1:2020 Financial services: International bank account number (IBAN)",
"url": "https://www.iso.org/standard/81090.html"
}
],
"warnings": []
}
Too short for the country
curl https://api.curatedapi.com/v1/calc/check/iban \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"number": "NL91 ABNA 0417 1643"
}'
{
"calculator": "check/iban@1",
"result": {
"valid": false,
"normalized": "NL91ABNA04171643",
"problem": "LENGTH",
"message": "An IBAN from Netherlands has 18 characters; this one has 16.",
"country": "NL",
"country_name": "Netherlands"
},
"exactness": {},
"precision": null,
"inputs": {
"number": "NL91 ABNA 0417 1643"
},
"formula": "move the first four characters to the end, read A as 10 … Z as 35, and the number must leave remainder 1 when divided by 97; check digits = 98 − (BBAN + country + 00) mod 97",
"references": [
{
"title": "SWIFT IBAN Registry, release 103 (September 2026) (ISO 13616)",
"url": "https://www.swift.com/resource/iban-registry-pdf"
},
{
"title": "ISO 13616-1:2020 Financial services: International bank account number (IBAN)",
"url": "https://www.iso.org/standard/81090.html"
}
],
"warnings": []
}
References
- SWIFT IBAN Registry, release 103 (September 2026) (ISO 13616)
- ISO 13616-1:2020 Financial services: International bank account number (IBAN)
Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.