curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

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

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).

InputTypeDescription
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.

ResultTypeDescription
validbooleanWhether the IBAN passes every check.
normalizedstringThe number as it was checked: separators removed, letters in upper case.
problemstringWhat 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.
messagestringThe result in a sentence, naming the rule that failed.
countrystringThe ISO 3166 country code.
country_namestringThe country's name in the registry.
check_digitsstringCharacters 3 and 4.
expected_check_digitsstringThe check digits ISO 13616 gives the country code and BBAN.
bbanstringThe Basic Bank Account Number: everything after the check digits.
formattedstringThe IBAN in groups of four.

Examples

The registry's United Kingdom example

Requestcurl
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"
  }'
200 OKResponse
{
  "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

Requestcurl
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"
  }'
200 OKResponse
{
  "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

Requestcurl
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"
  }'
200 OKResponse
{
  "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

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.