Validation

Validates an IBAN from any of 70+ countries: checksum, country length and in-country account structure, and resolves the bank and branch codes.

Most free libraries stop at the mod-97 checksum. That only says the digits are self-consistent — not that the number could exist in that country. This checks the country's BBAN structure too, so a wrong-length or wrong-shaped account is rejected before your payment file reaches the bank. When only the two check digits are wrong, the correct ones are computed and returned as a suggestion, because that is what people actually mistype. Turkish, Dutch and Belgian IBANs additionally resolve to a bank name when the national code is in our table; otherwise bankName is null. This is not a SWIFT directory.

Credits per call: 1 · Operation id: iban_validate

In the GET form every field is a query parameter; object and array fields are JSON-encoded.

get/v1/iban/validate

Request

  • Base URL: https://api.temsor.com
  • URL: https://api.temsor.com/v1/iban/validate
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

ibanstring required

IBAN, with or without spaces.

expectCountrystring

Expected country code (ISO 3166-1 alpha-2).

Response

Success

okunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.