IBAN Validation

Search…

IBAN Validation

An IBAN (International Bank Account Number) is an identification number for (nearly) every bank account in the world. Swan lets you fetch an IBAN's bank and account data as well as its reachability.

IBAN format check
First, the ibanValidation query lets you check the format of the IBAN. If there are any issues, we will return an error.
Valid IBAN
Invalid IBAN
query MyQuery {
  ibanValidation(input: { iban: "FR7817569000305414384277J07" }) {
    ... on ValidIban {
      __typename
      accountNumber
    }
    ... on InvalidIban {
      __typename
      message
      code
    }
  }
}
query MyQuery {
  ibanValidation(input: { iban: "FR76182060016265" }) {
    ... on ValidIban {
      __typename
      accountNumber
    }
    }
    ... on InvalidIban {
      __typename
      code
      message
    }
  }
}
​
​Try it now on the API Explorer​
IBAN resolving
To limit abuse in the Sandbox, the resolver provides only dummy data. 
Bank and account data
If the IBAN format is valid, Swan will return, when available, information about the account and bank associated to the IBAN: 
accountNumber: the account number (also referred to as the BBAN) 
bic: the BIC (Bank Identifier Code) of the bank holding the concerned account
nationalId: the bank's local identifier
branch: the bank branch where the account is opened
name: the name of the bank
address: the address of the bank
Reachability on payment schemes
The ibanValidation query also provides payment schemes reachability. A boolean, true/false, indicates whether or not the IBAN in question can be reached using one of the following payment schemes:
sepaCreditTransfer: if true, the IBAN can receive SEPA credit transfers​
sepaCreditTransferInst: if true, the IBAN can receive SEPA instant credit transfers
sepaDirectDebitCore: if true, the IBAN can receive SEPA direct debit core instructions​
sepaDirectDebitB2b: if true, the IBAN can receive SEPA direct debit B2B instructions​
At the moment, the only scheme available to send from Swan is SEPA Credit Transfers. We are actively working on delivering the SDD Core, SDD B2B, and SCT Inst schemes.
Usages
This feature enables some use cases like:
1.Error detection: before using the initiateCreditTransfers mutation, you can check if the IBAN is valid. This saves you the trouble of handling errors in case of incorrectly structured IBANs.
2.Display bank information in real-time: instead of displaying only the IBAN to your end-users, add the bank name, country, Bic code, address. Users know instantly if the IBAN they manipulate is the correct one. This prevents you from wiring money to the wrong account.

Last modified 8h ago

Export as PDF

Copy link

Outline

IBAN format check

IBAN resolving

Bank and account data

Reachability on payment schemes

Usages