Validation codes

List of available validation codes in API responses

Each IBAN validation returns a validations containing the results of each validation that was applied to the given IBAN in this format:

{
    "code": string, // unique validation code
    "valid": boolean, // true if the validation passed
    "message": string // verbose message explaining the validation result
}

Here are the validation codes that are currently supported:

OrderCodeDescription
1BASIC_FORMATThe IBAN has correct format (letters and numbers only)
2COUNTRY_CODEThe IBAN has a valid & supported country code
LENGTHThe IBAN has a valid length
4CHECKSUMThe IBAN has a valid checksum
5BBAN_FORMATThe IBAN has a valid BBAN format based on the country rules

If a validation fails, the API will stop processing the remaining validations, and immediately return the validations array.

If the validation fails, the details field of the response will be null.