NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

IBAN API

The IBAN API allows you to look up and validate any International Bank Account Number (IBAN).

Online
(4.3)

From 10,145 users

400+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
365ms379ms463ms790ms1304ms

Didn't find what you were looking for? Suggest an improvement

https://api.api-ninjas.com/v1/iban

Returns detailed information on a given IBAN.

Parameters

  • iban  required

    The IBAN to look up.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • iban

    The IBAN that was looked up.

  • bank_name Premium only

    The name of the bank associated with the IBAN.

  • bank_address Premium only

    The address of the bank associated with the IBAN.

  • swift_code Premium only

    The SWIFT/BIC code of the bank associated with the IBAN.

  • account_number

    The account number portion of the IBAN.

  • bank_code

    The bank code portion of the IBAN.

  • country

    The country code portion of the IBAN.

  • checksum

    The checksum portion of the IBAN.

  • valid Premium only

    Whether the IBAN is valid or not.

  • invalid_reason Premium only

    If the IBAN is not valid, a short code indicating why validation failed. null when the IBAN is valid.

  • bban

    The Basic Bank Account Number (BBAN) portion of the IBAN.

  • is_eu

    Whether the IBAN's country is an EU member state.

  • is_eea

    Whether the IBAN's country is in the European Economic Area.

  • is_sepa

    Whether the IBAN's country is in the Single Euro Payments Area — the flag that determines SEPA payment eligibility. Wider than the EU or EEA: it also includes Switzerland, the United Kingdom, Monaco, San Marino, Andorra and Vatican City.

Live Demo

Live demo · no API key required
Query parameters
iban

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/iban?iban=DE16200700000532013000
Sample response
{
"iban": "DE16200700000532013000",
"bank_name": "DEUTSCHE BANK AG",
"bank_address": "ADOLPHSPLATZ 7, HAMBURG, 20079",
"swift_code": "DEUTDEHH",
"account_number": "0532013000",
"bank_code": "20070000",
"country": "DE",
"checksum": "16",
"valid": true,
"invalid_reason": null,
"bban": "200700000532013000"
}

Code Examples

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

  • 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.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • 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.
  • 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.
  • Send a GET request to the /v1/iban endpoint with the required iban parameter set to the International Bank Account Number you want to look up, for example iban=DE16200700000532013000. Get a key from the registration page to start making requests.
  • The API decomposes the IBAN into its parts, returning account_number, bank_code, country, checksum, and the full bban (Basic Bank Account Number). It also resolves bank details such as bank_name, bank_address, swift_code, and the valid flag, which are available on premium plans.
  • The IBAN API is useful for validating customer bank details at checkout or onboarding via the valid field, and for enriching payment records with the resolved bank_name, bank_address, and swift_code. For non-IBAN banking identifiers you can pair it with our SWIFT Code API, Sort Code API, or Routing Number API.
  • Yes, the response includes a valid field indicating whether the supplied iban is valid, which is available on premium plans. Validation errors and other unsuccessful requests are documented on our error codes page.

Explore API integration use cases for recommended APIs and workflow examples.