Validate IBAN
This API is used to verify the accuracy and validity of an IBAN (International Bank Account Number). It ensures that the provided IBAN exists and is correctly formatted.
Note: This API does not create any Payment Contact in the system. It is intended solely for validation purposes and to retrieve the account title associated with the given IBAN.
POST{baseUrl}/be/api/v1/validate-iban
Payload
| Attribute | Description |
|---|---|
| iban | Required. A valid IBAN number. |
| accountTitle | Optional. If the third party does not return the account title, the user must provide the title as input. |
Request Example
{
"iban": "AE000000000000000000000",
"accountTitle": null
}Response
| Attribute | Description |
|---|---|
| data | Contains the account related information. |
| data.valid | true indicates whether the IBAN is valid or not. |
| data.uniqueReference | Unique reference for the validated IBAN. |
| data.details | Contains IBAN related data. |
| data.details.bankCode | Bank code of the given IBAN. |
| data.details.accountTitle | Account title of the given IBAN. |
| data.details.iban | The IBAN. |
| data.details.swiftCode | Swift code of the given IBAN. |
| data.details.bankName | Bank name of the given IBAN. |
200 — SUCCESS
{
"data": {
"valid": true,
"uniqueReference": "AE580300000002000007377",
"details": {
"bankCode": "030",
"accountTitle": "johm*",
"iban": "AE580300000002000007377",
"swiftCode": "IBTFAEASXXX",
"bankName": "INVESTBANK"
}
}
}422 — Account Title Missing
{
"code": 1000,
"message": "Invalid payload. Please check your request.",
"type": "INVALID_PAYLOAD",
"errors": [
{
"key": "accountTitle",
"reason": "Account title is missing"
}
]
}500 — Invalid IBAN
{
"code": 1010,
"message": "Invalid IBAN",
"type": "BAD_REQUEST"
}