IBAN API
The IBAN API allows you to look up and validate any International Bank Account Number (IBAN).
From 10,145 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 365ms | 379ms | 463ms | 790ms | 1304ms |
Didn't find what you were looking for? Suggest an improvement
/v1/iban GET
https://api.api-ninjas.com/v1/iban
Returns detailed information on a given IBAN.
Parameters
ibanrequiredThe IBAN to look up.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON object with the following fields or an error if the request is unsuccessful.
ibanThe IBAN that was looked up.
bank_namepremium onlyThe name of the bank associated with the IBAN.
bank_addresspremium onlyThe address of the bank associated with the IBAN.
swift_codepremium onlyThe SWIFT/BIC code of the bank associated with the IBAN.
account_numberThe account number portion of the IBAN.
bank_codeThe bank code portion of the IBAN.
countryThe country code portion of the IBAN.
checksumThe checksum portion of the IBAN.
validpremium onlyWhether the IBAN is valid or not.
bbanThe Basic Bank Account Number (BBAN) portion of the IBAN.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/iban?iban=DE16200700000532013000Headers
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/iban?iban=GB29NWBK60161331926819" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Frequently Asked Questions
Can I use the IBAN API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the IBAN API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the IBAN API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the IBAN API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.How do I look up an IBAN with the IBAN API?
Send a GET request to the/v1/ibanendpoint with the requiredibanparameter set to the International Bank Account Number you want to look up, for exampleiban=DE16200700000532013000. Get a key from the registration page to start making requests.What fields does the IBAN API return?
The API decomposes the IBAN into its parts, returningaccount_number,bank_code,country,checksum, and the fullbban(Basic Bank Account Number). It also resolves bank details such asbank_name,bank_address,swift_code, and thevalidflag, which are available on premium plans.What are some use cases for the IBAN API?
The IBAN API is useful for validating customer bank details at checkout or onboarding via thevalidfield, and for enriching payment records with the resolvedbank_name,bank_address, andswift_code. For non-IBAN banking identifiers you can pair it with our SWIFT Code API, Sort Code API, or Routing Number API.Can the IBAN API tell me whether an IBAN is valid?
Yes, the response includes avalidfield indicating whether the suppliedibanis valid, which is available on premium plans. Validation errors and other unsuccessful requests are documented on our error codes page.