CTRL+K
https://api.apifreaks.com/v1.0/iban/validation
$ pip install requests
Click Test it to start the request and see the response here!
| Field | Type | Requirement | Description |
|---|---|---|---|
| valid | boolean | Mandatory | Indicates whether the provided IBAN is valid according to country format, length, and checksum. |
| iban | string | Mandatory | The IBAN number provided by the user. |
| validation | object | Mandatory | Object contains IBAN validation details. |
| breakdown | object | Mandatory | Object contains the IBAN Structural Breakdown |
| bankInfo | object | Optional | Object contains the bank information for the provided IBAN number. |
| message | string | Mandatory | A human-readable message summarizing validation results. |
"validation" object contains the following fields.
| Field | Type | Requirement | Description |
|---|---|---|---|
| country | string | Mandatory | Full country name of the IBAN (e.g., "United Kingdom"). |
| countryCode | string | Mandatory | Two-character ISO alpha-2 country code (e.g., "GB"). |
| sepa | boolean | Mandatory | Indicates if the country is part of SEPA . |
| length | number | Mandatory | Expected length of IBAN for this country. |
| structure | string | Mandatory | IBAN structure format according to country-specific rules (e.g., "GB2!n4!a6!n8!n"). |
"breakdown" object contains the following fields.
| Field | Type | Requirement | Description |
|---|---|---|---|
| countryCode | string | Mandatory | Country code extracted from IBAN. |
| checkDigits | string | Mandatory | Two check digits used in IBAN validation (MOD97). |
| bankCode | string | Mandatory | Bank code portion of the IBAN/BBAN. |
| branchCode | string | Optional | Branch code portion of the IBAN/BBAN, if applicable. |
| accountNumber | string | Mandatory | The account number portion of the BBAN. |
| bban | string | Mandatory | Complete BBAN (bankCode + branchCode + accountNumber). |
| isBbanValid | boolean | string | Mandatory | BBAN checksum validation result: true/false, or string message if unsupported. |
"bankInfo" object contains the following fields.
| Field | Type | Requirement | Description |
|---|---|---|---|
| bankName | string | Optional | Official bank name. |
| swift_or_bic | string | Optional | SWIFT/BIC code of the bank, if available. |
| city | string | Optional | City where the bank is located. |
| country | string | Optional | Country where the bank is located. |
| bankCode | string | Optional | Bank code for the bank, if available. |
| bankAddress | string | Optional | Address of the bank, if available. |