How does it work?

openiban.com allows Cross Domain Access. You can easily add the validation to your own site by using the following JavaScript snippet:

$.ajax({
	url: 'https://openiban.com/validate/DE89370400440532013000',	// replace with
								// dynamic value
	data: { // pass additional options
		"validateBankCode": true, 	// (not guaranteed)
		"getBIC": true 			// (not guaranteed)
	},
	success: function(data) {
		var result = data;
		if(result.valid) {
			// YOUR LOGIC
			//
		}
	},
	error: function(xhr) {
		// handle error
	}
});
		          

REST

You can also use the REST Webservice directly in your application. Just send a GET request to

And replace IBAN_NUMBER with the value that should be validated. The response will be in the format of:

{
  "valid": true, 		// either true or false
  "messages": [ 		// states the reason if "valid" is false
    "Bank code valid: 37040044"
  ],
  "iban": "DE89370400440532013000",	// the IBAN which was to be validated
  "bankData": {
    "bankCode": "37040044",
    "name": "Commerzbank",
    "zip": "50447",
    "city": "Köln",
    "bic": "COBADEFF3701"
  },
  "checkResults": {
    "bankCode": true 		// info about your additional check requests
  }
}
							

Country codes

You can retrieve a map of country codes through the /countries endpoint

$.ajax({
	url: 'https://openiban.com/countries',
	success: function(data) {
		// ...
	},
	error: function(xhr) {
		// handle error
	}
});
		          

Response

The response has the format of:

{
  "Albania": "AL",
  "Algeria": "DZ",
  // ...
}
							

IBAN Calculation (beta)

For calculation of IBAN numbers you can use the /calculate endpoint:

$.ajax({
  url: 'https://openiban.com/v2/calculate/<country>/<bankCode>/<accountNumber>',
  success: function(data) {
    var result = data;
    if(result.valid) {
      // YOUR LOGIC
    }
  },
  error: function(xhr) {
    // handle error
  }
});
		          

Response

A successful calculation returns status code 200 and a result similar to the /validation endpoint.

{
  "valid": true, 		// either true or false
  "messages": [ 		// states the reason if "valid" is false
    "Bank code valid: <bankCode>"
  ],
  "iban": "<iban>",	// the IBAN which was generated
  "bankData": {
    "bankCode": "<bankCode>",
    "name": "<bankName>",
    "zip": "<zipCode>",
    "city": "<city>",
    "bic": "<BIC>"
  },
  "checkResults": {
    "bankCode": true 		// info about your additional check requests
  }
}