CINXE.COM

<!DOCTYPE html>  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  <title>Bank Suite API Documentation</title> <meta name="description" content="" /> <meta name="keywords" content="" /> <meta name="theme-color" content="#153570"> <meta name="apple-mobile-web-app-status-bar-style" content="#153570"> <meta name="MobileOptimized" content="width" /> <meta name="HandheldFriendly" content="true" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="preconnect" href="https://www.google.com" crossorigin> <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> <link rel="preconnect" href="https://www.google-analytics.com" crossorigin> <link rel="preconnect" href="https://cdnjs.cloudflare.com" crossorigin> <link href="https://www.iban.com/bank-suite-api" rel="canonical"> <link rel="alternate" href="https://www.iban.com/bank-suite-api" hreflang="x-default" /> <link rel="alternate" href="https://www.iban.com/bank-suite-api" hreflang="en" /> <link rel="alternate" href="https://de.iban.com/bank-suite-api" hreflang="de" /> <link rel="alternate" href="https://fr.iban.com/bank-suite-api" hreflang="fr" /> <link rel="alternate" href="https://es.iban.com/bank-suite-api" hreflang="es" /> <link rel="alternate" href="https://pt.iban.com/bank-suite-api" hreflang="pt" /> <link rel="alternate" href="https://nl.iban.com/bank-suite-api" hreflang="nl" /> <link rel="alternate" href="https://it.iban.com/bank-suite-api" hreflang="it" /> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.5.3/css/bootstrap.min.css" integrity="sha512-oc9+XSs1H243/FRN9Rw62Fn8EtxjEYWHXRvjS43YtueEewbS6ObfXcJNyohjHqVKFPoXXUxwc+q1K7Dee6vv9g==" crossorigin="anonymous" /> <link rel="stylesheet" type="text/css" href="/stylesheets/style.css?v=2"> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" integrity="sha512-SfTiTlX6kk+qitfevl/7LibUOeJWlt9rbyDn92a1DqWOw9vWG2MFoays0sgObmWazO5BQPiFucnnEAjpAB+/Sw==" crossorigin="anonymous" /> </head> <body> <div class="boxed"> <div class="topheader"> <div class="container"> <div class="row"> <div class="col-4"> <div class="top-navigator float-left"> <ul> <li ><a href="/contact" title="Contact Us" class="no-border"><i class="fa fa-envelope"></i> Contact</a></li> </ul> </div> </div> <div class="col-8"> <div class="top-navigator float-right"> <ul> <li class="d-none d-sm-inline-block"><a href="#" class="language"><img src="/images/icon/blank.png" class="flag flag-gb" width="16" height="11" alt="en"> EN</a> <ul> <li><a href="https://de.iban.com/" title="Deutsch" data-lang-id="de_DE"><img src="/images/icon/blank.png" class="flag flag-de" width="16" height="11" alt="de"> Deutsch</a></li> <li><a href="https://fr.iban.com/" title="Français" data-lang-id="fr_FR"><img src="/images/icon/blank.png" class="flag flag-fr" width="16" height="11" alt="fr"> Français</a></li> <li><a href="https://it.iban.com/" title="Italiano" data-lang-id="it_IT"><img src="/images/icon/blank.png" class="flag flag-it" width="16" height="11" alt="it"> Italiano</a></li> <li><a href="https://nl.iban.com/" title="Dutch" data-lang-id="nl_NL"><img src="/images/icon/blank.png" class="flag flag-nl" width="16" height="11" alt="nl"> Dutch</a></li> <li><a href="https://es.iban.com/" title="Español" data-lang-id="es_ES"><img src="/images/icon/blank.png" class="flag flag-es" width="16" height="11" alt="es"> Español</a></li> <li><a href="https://pt.iban.com/" title="Português" data-lang-id="pt_PT"><img src="/images/icon/blank.png" class="flag flag-pt" width="16" height="11" alt="pt"> Português</a></li> <li><a href="https://www.iban.pl/" title="Polski" data-lang-id="pl"><img src="/images/icon/blank.png" class="flag flag-pl" width="16" height="11" alt="pl"> Polski</a></li> <li><a href="https://www.iban.se/" title="Svenska" data-lang-id="sv"><img src="/images/icon/blank.png" class="flag flag-se" width="16" height="11" alt="sv"> Svenska</a></li> <li><a href="https://www.iban.fi/" title="Suomi" data-lang-id="fi"><img src="/images/icon/blank.png" class="flag flag-fi" width="16" height="11" alt="fi"> Suomi</a></li> <li><a href="https://www.iban.dk/" title="Dansk" data-lang-id="da"><img src="/images/icon/blank.png" class="flag flag-dk" width="16" height="11" alt="da"> Dansk</a></li> <li><a href="https://www.iban.co.no/" title="Norsk" data-lang-id="no"><img src="/images/icon/blank.png" class="flag flag-no" width="16" height="11" alt="no"> Norsk</a></li> <li><a href="https://www.iban.hu/" title="Magyar" data-lang-id="hu"><img src="/images/icon/blank.png" class="flag flag-hu" width="16" height="11" alt="hu"> Magyar</a></li> <li><a href="https://www.iban.gr/" title="Eλληνική" data-lang-id="el"><img src="/images/icon/blank.png" class="flag flag-gr" width="16" height="11" alt="el"> Eλληνική</a></li> <li><a href="https://www.iban.cz/" title="Čeština" data-lang-id="cs"><img src="/images/icon/blank.png" class="flag flag-cz" width="16" height="11" alt="cs"> Čeština</a></li> <li><a href="https://www.iban.si/" title="Slovenščina" data-lang-id="sv"><img src="/images/icon/blank.png" class="flag flag-si" width="16" height="11" alt="sl"> Slovenščina</a></li> <li><a href="https://www.iban.hr/" title="Hrvatski" data-lang-id="hr_HR"><img src="/images/icon/blank.png" class="flag flag-hr" width="16" height="11" alt="hr"> Hrvatski</a></li> <li><a href="https://www.iban.sk/" title="Slovenský" data-lang-id="sk"><img src="/images/icon/blank.png" class="flag flag-sk" width="16" height="11" alt="sk"> Slovenský</a></li> <li><a href="https://www.iban.lv/" title="Latviešu" data-lang-id="lv"><img src="/images/icon/blank.png" class="flag flag-lv" width="16" height="11" alt="lv"> Latviešu</a></li> <li><a href="https://www.iban.lt/" title="Lietuvių" data-lang-id="lt"><img src="/images/icon/blank.png" class="flag flag-lt" width="16" height="11" alt="lt"> Lietuvių</a></li> <li><a href="https://www.iban.ee/" title="Eesti" data-lang-id="et"><img src="/images/icon/blank.png" class="flag flag-ee" width="16" height="11" alt="et"> Eesti</a></li> <li><a href="https://www.iban.rs/" title="Srpski" data-lang-id="sr"><img src="/images/icon/blank.png" class="flag flag-rs" width="16" height="11" alt="sr"> Srpski</a></li> <li><a href="https://www.ibankodu.com.tr/" title="Türkçe" data-lang-id="tr"><img src="/images/icon/blank.png" class="flag flag-tr" width="16" height="11" alt="tr"> Türkçe</a></li> <li><a href="https://www.iban.ru/" title="Русский" data-lang-id="ru_RU"><img src="/images/icon/blank.png" class="flag flag-ru" width="16" height="11" alt="ru"> Русский</a></li> <li><a href="https://www.iban.bg/" title=" Български" data-lang-id="bg"><img src="/images/icon/blank.png" class="flag flag-bg" width="16" height="11" alt="bg"> Български</a></li> <li><a href="https://www.iban.com.ua/" title="Українська" data-lang-id="uk"><img src="/images/icon/blank.png" class="flag flag-ua" width="16" height="11" alt="uk"> Українська</a></li> <li><a href="https://www.iban.ma/" title="العربية" data-lang-id="ar"><img src="/images/icon/blank.png" class="flag flag-ma" width="16" height="11" alt="ar"> العربية</a></li> <li><a href="https://www.iban.co.il/" title="עברית" data-lang-id="he"><img src="/images/icon/blank.png" class="flag flag-il" width="16" height="11" alt="he"> עברית</a></li> <li><a href="https://www.iban.jp/" title="日本語" data-lang-id="ja"><img src="/images/icon/blank.png" class="flag flag-jp" width="16" height="11" alt="ja"> 日本語</a></li> <li><a href="https://www.iban.kr/" title="한국어" data-lang-id="ko"><img src="/images/icon/blank.png" class="flag flag-kr" width="16" height="11" alt="ko"> 한국어</a></li> <li><a href="https://www.iban.hk/" title="繁體中文" data-lang-id="zh-TW"><img src="/images/icon/blank.png" class="flag flag-hk" width="16" height="11" alt="zh-TW"> 繁體中文</a></li>  </ul> </li> <li></li> <li><a href="https://clients.iban.com/login" title="Member Login" class="login"><i class="fa fa-lock no-border" aria-hidden="true"></i>Login</a></li> <li><a href="https://clients.iban.com/register" title="Request a trial account" class="requesttrial d-none d-sm-inline-block">Register</a></li> </ul> </div> </div> </div> </div> </div> <header id="header" class="header clearfix"> <div class="header-wrap clearfix"> <div class="container"> <div class="row"> <div class="col-md-12"> <div id="logo" class="logo"> <a href="/" title="IBAN Home"> <img src="/images/logo.png" alt="IBAN Logo" width="170" height="75"> </a> </div> <div class="btn-menu"> <span></span> </div> <div class="nav-wrap"> <nav id="mainnav" class="mainnav navbar-right"> <ul class="menu"> <li><a href="/iban-checker" title="Check IBAN Number"><i class="fa fa-check"></i> <div class="atitle">Validate IBAN</div></a></li> <li><a href="/calculate-iban" title="IBAN Calculator"><i class="fa fa-retweet"></i> <div class="atitle">Calculate IBAN</div></a></li> <li><a href="/products" title="Products and services"><i class="fa fa-th-large" ></i> <div class="atitle">Products</div></a></li> <li><a href="/why-iban" title="Why choose IBAN Services"><i class="fa fa-question-circle" aria-hidden="true"></i> <div class="atitle">Why IBAN</div></a></li> <li><a class="active" href="/developers" title="Developers Documentation"><i class="fa fa-cogs"></i> <div class="atitle">Developers</div></a></li> <li><a href="/pricing" title="Order products and services"><i class="fa fa-tasks"></i> <div class="atitle">Pricing</div></a></li> </ul> </nav> </div> </div> </div> </div> </div> </header> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shCore.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushPhp.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushBash.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushXml.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushVb.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushJava.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushJScript.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushCSharp.js"></script> <link type="text/css" rel="stylesheet" href="../javascript/syntaxhighlighter/styles/shCoreDefault.css"/> <script language='javascript'> SyntaxHighlighter.all(); </script> <div class="flat-row flat-general apidocs sidebar-left" > <div class="container-flud"> <div class="flat-wrapper"> <div class="general-sidebar pad-bottom180px" data-spy="affix" data-offset-top="205"> <div class="sidebar-wrap"> <div class="sidebar" > <nav id="myScrollspy"> <div class="widget widget_nav_menu"> <ul class="nav_menu" id="menu-main-menu">  <li style="background-color:#ffdecb;" class="menu-item"><a href="#section1"><span>1. Introduction</span></a></li> <li style="background-color:#ffeccb;" class="menu-item"><a href="#section2"><span>2. Features</span></a></li> <li style="background-color:#fff3cb;" class="menu-item"><a href="#section3"><span>3. API Endpoints</span></a></li> <li style="background-color:#faffcb;" class="menu-item"><a href="#section4"><span>4. BANK CODE API INPUT</span></a></li> <li style="background-color:#faffcb;" class="menu-item"><a href="#section41"><span>4.1 BANK CODE API OUTPUT</span></a></li> <li style="background-color:#faffcb;" class="menu-item"><a href="#section42"><span>4.2 BANK CODE API ERRORS</span></a></li> <li style="background-color:#e0ffcb;" class="menu-item"><a href="#section5"><span>5. BIC API INPUT</span></a></li> <li style="background-color:#e0ffcb;" class="menu-item"><a href="#section51"><span>5.1 BIC API OUTPUT</span></a></li> <li style="background-color:#e0ffcb;" class="menu-item"><a href="#section52"><span>5.2 BIC API ERRORS</span></a></li> <li style="background-color:#bfefc7;" class="menu-item"><a href="#section6"><span>6. STRUCTURE API INPUT</span></a></li> <li style="background-color:#bfefc7;" class="menu-item"><a href="#section61"><span>6.1 STRUCTURE API OUTPUT</span></a></li> <li style="background-color:#bfefc7;" class="menu-item"><a href="#section62"><span>6.2 STRUCTURE API ERRORS</span></a></li> <li style="background-color:#bfe9ef;" class="menu-item"><a href="#section7"><span>7. Data Fields Definitions</span></a></li> <li style="background-color:#bfdcef;" class="menu-item"><a href="#section8"><span>8. Supported Countries</span></a></li> </ul> </div> </nav> </div> </div> </div> <div class="general flat-clients pad-bottom180px"> <div class="general-text"> <div class="flat-title-button"> <h1 class="title">Bank Suite API Documentation</h1> </div> <br style="clear:both;"> <h5>This API is part of our <a href="/bank-suite">Bank Suite</a> service</h5> <div id="section1" class="item"> <h4>1. Introduction</h4> <br> The Bank Suite is a web service which provides validation capabilities for bank codes and account numbers.<br> Designed mainly to provide bank code and account number validation for countries which do not use the IBAN standard (see list of countries ).<br> Powered by the one of the largest and up to date bank code directories in the industry it is a powerful suit of services helping businesses improve the quality of international payments<br> <br> <br> </div> <hr> <div id="section2" class="item"> <h4>2. Features</h4><br> Some of the key features and benefits of the Bank Suite service are:<br><br> <ul class="flat-list style1"> <li>Global Coverage</li> <li>Validate Bank Codes for non-IBAN countries</li> <li>Validate domestic bank code and account number check digits</li> <li>Monthly updated world bank directory covering 195 countries</li> <li>Query the bank suite directory by Bank Code(National ID)</li> <li>Query the bank suite directory by BIC code </li> <li>Validate Bank Code structure</li> <li>Validate Bank Code length</li> <li>Identify BIC code related to bank routing/sorting code</li> </ul> <br>                                    </div> <hr> <div id="section3" class="item"> <h4>3. API Endpoints</h4><br> <br> The Bank Suite API provides the following endpoints:<br> <br> <strong>Main Endpoint - Validate bank code (NID)</strong><br> <a href="http://api.iban.com/clients/api/banksuite/nid/">http://api.iban.com/clients/api/banksuite/nid/</a><br> <br> This endpoint is used to validate bank codes and retrieve information about the bank and branch they belong.<br> It also provides an additional feature to validate bank account numbers by checking their structure, formatting, length and check digit.<br> <br> <strong>BIC Endpoint - Search by BIC Code</strong><br> <a href="http://api.iban.com/clients/api/banksuite/bic/">http://api.iban.com/clients/api/banksuite/bic/</a><br> <br> This endpoint performs validation on a provided BIC code and performs a search in our banking directory.<br> If the BIC is currently active and in use, the system will provide bank code and bank and branch information related to this BIC<br> <br> <strong>Structure Endpoint - Information about format and structure.</strong><br> <a href="http://api.iban.com/clients/api/banksuite/structure/">http://api.iban.com/clients/api/banksuite/structure/</a><br> <br> The structure endpoint provides information about bank code and account number structure for each specific country. <br> <br> </div>    <div id="section4" class="item"> <h4>4. Bank Code API Input</h4> The REST API accepts both HTTP GET or POST requests.<br> The input parameters are listed in the table below:<br><br> <table class="table table-bordered examples"> <thead> <tr> <th width="189">Field Name</th> <th width="103">Length</th> <th width="69">Type</th> <th width="487">Description</th> </tr> </thead> <tbody> <tr> <td width="189">nid</td> <td width="103">Max 15</td> <td width="69">String</td> <td width="487">The Bank Code sent to our system for validation.</td> </tr> <tr> <td width="189">account</td> <td width="103">Max 50</td> <td width="69">String</td> <td width="487">(optional) Account number sent for validation. </td> </tr> <tr> <td width="189">country_iso</td> <td width="103">Max 2</td> <td width="69">String</td> <td width="487">2 letter ISO Code of the country. List of supported countries in <a href="#section8"><span>Section 8. Supported Countries</span></a></td> </tr> <tr> <td width="189">api_key</td> <td width="103">128</td> <td width="69">String</td> <td width="487">Your personal API key.</td> </tr> <tr> <td width="189">format</td> <td width="103">5</td> <td width="69">String</td> <td width="487">Format of the response XML and JSON supported.</td> </tr> </tbody> </table> <br> *To obtain an API key, please contact us at <a href="mailto:contact@iban.com">contact@iban.com</a> or purchase a subscription at our <a href="pricing"> order page </a> <br><br> <strong>EXAMPLE – Validate a Bank Code </strong><br> Feel free to use the sample code below to test the API in the most common programming languages.<br> <br> <div id="tabbed-nav"> <ul> <li><a>CURL</a></li> <li><a>PHP</a></li> <li><a>RUBY</a></li> <li><a>PYTHON</a></li> <li><a>Perl</a></li> <li><a>JAVA</a></li> <li><a>.NET</a></li> <li><a>NODE</a></li> </ul> <div> <div> <pre class="brush: bash;"> curl "https://api.iban.com/clients/api/banksuite/nid/" \ -X POST \ -d format=json \ -d api_key=[YOUR_API_KEY] \ -d country_iso=US -d nid=322271627 </pre> </div> <div> <pre class="brush: php;"> <?php $curl = curl_init(); $post = [ 'format' => 'json', 'api_key' => '[YOUR_API_KEY]', 'country_iso' => 'US', 'nid' => '322271627' ]; curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.iban.com/clients/api/banksuite/nid/', CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $post )); $output = curl_exec($curl); $result = json_decode($output); print_r($result); curl_close($curl); ?> </pre> </div> <div> <pre class="brush: php;"> require 'net/http' uri = URI('https://api.iban.com/clients/api/banksuite/') res = Net::HTTP.post_form(uri, "format" => "json", "api_key" => "[YOUR_API_KEY]","country_iso" => "US","nid" => "322271627") puts res.body </pre> </div> <div> <pre class="brush: php;"> import requests post_data = {'format':'json', 'api_key':'[YOUR_API_KEY]','country_iso':'US','nid':'322271627'} response = requests.post('https://api.iban.com/clients/api/banksuite/nid/',post_data) print(response.text) </pre> </div> <div> <pre class="brush: php;"> use LWP::UserAgent; my $ua = LWP::UserAgent->new; my $server_endpoint = "https://api.iban.com/clients/api/banksuite/nid/"; my $format = 'json'; my $api_key = '[YOUR_API_KEY]'; my $country_iso = 'US'; my $nid = '322271627'; my $req = HTTP::Request->new( POST => $server_endpoint ); $req->content_type('application/x-www-form-urlencoded'); my $post_data = 'format=' . $format . '&api_key=' . $api_key . '&country_iso=' . $country_iso . '&nid=' . $nid; $req->content($post_data); my $resp = $ua->request($req); if ( $resp->is_success ) { my $message = $resp->decoded_content; print $message; } </pre> </div> <div> <h4>JAVA</h4> <pre class="brush: csharp;"> import java.io.BufferedReader; import java.io.DataOutputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import javax.net.ssl.HttpsURLConnection; import org.json.simple.JSONObject; import org.json.simple.JSONArray; import org.json.simple.parser.ParseException; import org.json.simple.parser.JSONParser; public class ibanapi { private final String USER_AGENT = "API Client/1.0"; public static void main(String[] args) throws Exception { ibanapi http = new ibanapi(); System.out.println("\nTesting API - Send API POST request"); http.sendPost(); } // HTTP POST request private void sendPost() throws Exception { String url = "https://api.iban.com/clients/api/banksuite/nid/"; URL obj = new URL(url); HttpsURLConnection con = (HttpsURLConnection) obj.openConnection(); //add reuqest header con.setRequestMethod("POST"); con.setRequestProperty("User-Agent", USER_AGENT); con.setRequestProperty("Accept-Language", "en-US,en;q=0.5"); String urlParameters = "api_key=[YOUR_API_KEY]&format=json&country_iso=US&nid=322271627"; // Send post request con.setDoOutput(true); DataOutputStream wr = new DataOutputStream(con.getOutputStream()); wr.writeBytes(urlParameters); wr.flush(); wr.close(); int responseCode = con.getResponseCode(); System.out.println("\nSending 'POST' request to URL : " + url); System.out.println("Post parameters : " + urlParameters); System.out.println("Response Code : " + responseCode); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); //print result System.out.println(response.toString()); } } </pre> </div> <div> <h4>.NET</h4> <pre class="brush: java;"> public static void Main(string[] args) { var request = (HttpWebRequest)WebRequest.Create("https://api.iban.com/clients/api/banksuite/nid/"); var postData = "api_key=[YOUR_API_KEY]"; postData += "&format=json"; postData += "&country_iso=US"; postData += "&nid=322271627"; var data = Encoding.ASCII.GetBytes(postData); request.Method = "POST"; request.ContentType = "application/x-www-form-urlencoded"; request.ContentLength = data.Length; using (var stream = request.GetRequestStream()) { stream.Write(data, 0, data.Length); } var response = (HttpWebResponse)request.GetResponse(); var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd(); Console.WriteLine(responseString); Console.Write("Press any key to continue . . . "); Console.ReadKey(true); } </pre> </div> <div> <h4>NODE</h4> <pre class="brush: java;"> var request = require('request'); var headers = { 'User-Agent': 'IBAN API Client/0.0.1', 'Content-Type': 'application/x-www-form-urlencoded' } var options = { url: 'https://api.iban.com/clients/api/banksuite/nid/', method: 'POST', headers: headers, form: {'api_key': '[YOUR_API_KEY]', 'format': 'json', 'country_iso': 'US', 'nid': '322271627'} } request(options, function (error, response, body) { if (!error && response.statusCode == 200) { var data = JSON.parse(body); console.log(data.error); console.log("Query Status: " + data.success); console.log("Bank Code Valid: " + data.nid_valid); console.log("Bank Name: " + data.directory_results.institution_name); console.log("Bank BIC: " + data.directory_results.bic); } }) </pre> </div> </div> </div><br> An example usage of the BankSuite API with a GET request can be:<br><br> <a class="green" href="https://api.iban.com/clients/api/banksuite/nid/?format=json&api_key=[API_KEY]&country_iso=US&nid=322271627" target="_new">https://api.iban.com/clients/api/banksuite/nid/?format=json&api_key=[API_KEY]&country_iso=US&nid=322271627</a><br><br> Where:<br> <ul class="flat-list style1"> <li>key is your API key</li> <li>NID is the bank code sent for validation by the API module.</li> <li>xml is the response format. Also a json keyword can be specified for json formatted response.</li> </ul><br> Once an HTTP GET or POST request is made with the correct API key, the system will return the results in the specified format. <br> </div> <hr> <div id="section41" class="item"> <h4>4.1 Bank Code API Output</h4> An XSD Schema of the API’s response can be found below:<br> XSD Schema for NID endpoint: <a href="https://www.iban.com/files/banksuite/nid.xsd"> download </a><br> <br> <br> The API results are delivered in JSON or XML format for maximum usability. Find below descriptions for the JSON properties returned by the API:<br> <br> <table class="table table-bordered examples"> <thead> <tr> <th>Object</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>QUERY</td> <td>Array</td> <td>Contains the user supplied input parameters.</td> </tr> <tr> <td>SUCCESS</td> <td>Boolean</td> <td>Indicates a true or false indicating if the query succeeded</td> </tr> <tr> <td>ACCOUNT_VALID</td> <td>Boolean</td> <td>True or False. Indicates if the account number supplied has passed all validations</td> </tr> <tr> <td>NID_VALID</td> <td>Boolean</td> <td>True or False. Indicates if the bank code has passed all validations</td> </tr> <tr> <td>RECORDS_FOUND</td> <td>Integer</td> <td>Indicates the number of records found in the bank directory. If more than one, you may use the 'limit' parameter to retrieve multiple records for the same bank code</td> </tr> <tr> <td>RECORDS_DISPLAYED</td> <td>Integer</td> <td>Indicates the number of records displayed in the 'directory_results' object. By default we display one record. With the 'limit' parameter, you can retrieve multiple</td> </tr> <tr> <td>DIRECTORY_RESULTS</td> <td>Array</td> <td>This object contains the data retrieved from our bank directory for the respective bank code. You may find a detailed description of this object in <a href="">Section 7 Data Field Definitions</a></td> </tr> <tr> <td>ERROR</td> <td>Object</td> <td>Provides error code and description if an error occurs. For descriptions, please refer to <a href="">Section 4.2 Bank Code API Errors</a></td> </tr> </tbody> </table> <br> <br> A sample JSON reply from the API for a IBAN validation query would be:<br> <pre class="brush: js;"> { "query": { "country_iso": "DE", "nid": "37040044", "account": "3901190310" }, "success": true, "account_valid": false, "nid_valid": true, "records_found": "17", "records_displayed": 1, "directory_results": [ { "office_type": "DB", "legal_type": "B", "institution_status": "BANK", "iso_lei_code": "", "bic8": "COBADEFF", "branch_bic": "366", "bic": "COBADEFF366", "chips_uid": "", "national_id": "37040044", "connected_bic": "COBADEFF366", "institution_name": "COMMERZBANK AG", "branch_information": "Commerzbank Pulheim", "pob_number": "", "street_address_1": "KAISERSTRASSE 16", "street_address_2": "", "street_address_3": "", "street_address_4": "", "city": "FRANKFURT AM MAIN", "cps": "HESSE", "zip_code": "60261", "country_name": "GERMANY", "iso_country_code": "DE", "subtype_indicator": "SUPE", "network_connectivity": "CNN", "service_codes": "EBAERPFINTG+" } ], "error": { "code": "813", "message": "Invalid Account Check Digit" } } </pre> </div> <hr> <div id="section42" class="item"> <br> <h4>4.2 Bank Code API Errors</h4> We utilize two types of errors for this endpoint.<br> "Query Failed" error indicates that validations were not carried out.<br> "Validation failed" error indicates that the bank code or account number submitted has failed a validation step.<br> <br> <table class="table table-bordered downloads"> <thead> <tr> <th>Error Code</th> <th>HTTP Status Code</th> <th>Type</th> <th>Message</th> </tr> </thead> <tbody> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>301</td><td>403</td><td>Query failed</td><td>API Key is invalid</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>305</td><td>403</td><td>Query failed</td><td>IP Address not allowed</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>304</td><td>403</td><td>Query failed</td><td>You have no access to this API</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>302</td><td>403</td><td>Query failed</td><td>Subscription expired</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>303</td><td>403</td><td>Query failed</td><td>No queries available</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>306</td><td>400</td><td>Query failed</td><td>Bad Request. Required minimum parameters: api_key; format; iso; nid</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>806</td><td>400</td><td>Query failed</td><td>Invalid value for 'limit' parameter</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>500</td><td>500</td><td>Query failed</td><td>Internal Server Error</td></tr> <tr style="background-color: #fefae2;"><td>801</td><td>200</td><td>Validation failed</td><td>Invalid Characters in NID</td></tr> <tr style="background-color: #fefae2;"><td>802</td><td>200</td><td>Validation failed</td><td>Country ISO code invalid</td></tr> <tr style="background-color: #fefae2;"><td>803</td><td>200</td><td>Validation failed</td><td>Unsupported country ISO code</td></tr> <tr style="background-color: #fefae2;"><td>804</td><td>200</td><td>Validation failed</td><td>NID length is not correct for US Accepted length for US: 9 characters.</td></tr> <tr style="background-color: #fefae2;"><td>805</td><td>200</td><td>Validation failed</td><td>Invalid NID format. Example: 211770093</td></tr> <tr style="background-color: #fefae2;"><td>400</td><td>200</td><td>Validation failed</td><td>BankCode(NID) not found in the official directory</td></tr> <tr style="background-color: #fefae2;"><td>809</td><td>200</td><td>Validation failed</td><td>Invalid Characters in account</td></tr> <tr style="background-color: #fefae2;"><td>810</td><td>200</td><td>Validation failed</td><td>Country ISO code invalid</td></tr> <tr style="background-color: #fefae2;"><td>811</td><td>200</td><td>Validation failed</td><td>Account Number length is not correct for US</td></tr> <tr style="background-color: #fefae2;"><td>812</td><td>200</td><td>Validation failed</td><td>Invalid Account format. Example: 39581126</td></tr> <tr style="background-color: #fefae2;"><td>813</td><td>200</td><td>Validation failed</td><td>Invalid Account Check Digit</td></tr> <tr style="background-color: #fefae2;"><td>814</td><td>200</td><td>Validation failed</td><td>Invalid Bank Code/NID Check Digit</td></tr> </tbody> </table> </div>       <div id="section5" class="item"> <h4>5. BIC API Input</h4> The BIC Code endpoint is designed to locate a bank code from a given BIC code in the Bank Suite directory.<br> The input parameters are listed in the table below:<br><br> <table class="table table-bordered examples"> <thead> <tr> <th width="189">Field Name</th> <th width="103">Length</th> <th width="69">Type</th> <th width="487">Description</th> </tr> </thead> <tbody> <tr> <td width="189">bic</td> <td width="103">Max 11</td> <td width="69">String</td> <td width="487">The BIC sent to our system for validation and identification.</td> </tr> <tr> <td width="189">api_key</td> <td width="103">128</td> <td width="69">String</td> <td width="487">Your personal API key.</td> </tr> <tr> <td width="189">format</td> <td width="103">5</td> <td width="69">String</td> <td width="487">Format of the response XML and JSON supported.</td> </tr> </tbody> </table> <br> *To obtain an API key, please contact us at <a href="mailto:contact@iban.com">contact@iban.com</a> or purchase a subscription at our <a href="pricing"> order page </a> <br><br> <strong>EXAMPLE – Validate and lookup BIC </strong><br> Feel free to use the sample code below to test the API in the most common programming languages.<br> <br> <div id="tabbed-nav2"> <ul> <li><a>CURL</a></li> <li><a>PHP</a></li> <li><a>RUBY</a></li> <li><a>PYTHON</a></li> <li><a>Perl</a></li> <li><a>JAVA</a></li> <li><a>.NET</a></li> <li><a>NODE</a></li> </ul> <div> <div> <pre class="brush: bash;"> curl "https://api.iban.com/clients/api/banksuite/bic/" \ -X POST \ -d format=json \ -d api_key=[YOUR_API_KEY] \ -d bic=BARCGB22XXX </pre> </div> <div> <pre class="brush: php;"> <?php $curl = curl_init(); $post = [ 'format' => 'json', 'api_key' => '[YOUR_API_KEY]', 'bic' => 'BARCGB22XXX' ]; curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.iban.com/clients/api/banksuite/bic/', CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $post )); $output = curl_exec($curl); $result = json_decode($output); print_r($result); curl_close($curl); ?> </pre> </div> <div> <pre class="brush: php;"> require 'net/http' uri = URI('https://api.iban.com/clients/api/banksuite/bic/') res = Net::HTTP.post_form(uri, "format" => "json", "api_key" => "[YOUR_API_KEY]","bic" => "BARCGB22XXX") puts res.body </pre> </div> <div> <pre class="brush: php;"> import requests post_data = {'format':'json', 'api_key':'[YOUR_API_KEY]','bic':'BARCGB22XXX'} response = requests.post('https://api.iban.com/clients/api/banksuite/bic/',post_data) print(response.text) </pre> </div> <div> <pre class="brush: php;"> use LWP::UserAgent; my $ua = LWP::UserAgent->new; my $server_endpoint = "https://api.iban.com/clients/api/banksuite/bic/"; my $format = 'json'; my $api_key = '[YOUR_API_KEY]'; my $bic = 'BARCGB22XXX'; my $req = HTTP::Request->new( POST => $server_endpoint ); $req->content_type('application/x-www-form-urlencoded'); my $post_data = 'format=' . $format . '&api_key=' . $api_key . '&bic=' . $bic; $req->content($post_data); my $resp = $ua->request($req); if ( $resp->is_success ) { my $message = $resp->decoded_content; print $message; } </pre> </div> <div> <h4>JAVA</h4> <pre class="brush: csharp;"> import java.io.BufferedReader; import java.io.DataOutputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import javax.net.ssl.HttpsURLConnection; import org.json.simple.JSONObject; import org.json.simple.JSONArray; import org.json.simple.parser.ParseException; import org.json.simple.parser.JSONParser; public class ibanapi { private final String USER_AGENT = "API Client/1.0"; public static void main(String[] args) throws Exception { ibanapi http = new ibanapi(); System.out.println("\nTesting API - Send API POST request"); http.sendPost(); } // HTTP POST request private void sendPost() throws Exception { String url = "https://api.iban.com/clients/api/banksuite/bic/"; URL obj = new URL(url); HttpsURLConnection con = (HttpsURLConnection) obj.openConnection(); //add reuqest header con.setRequestMethod("POST"); con.setRequestProperty("User-Agent", USER_AGENT); con.setRequestProperty("Accept-Language", "en-US,en;q=0.5"); String urlParameters = "api_key=[YOUR_API_KEY]&format=json&bic=BARCGB22XXX"; // Send post request con.setDoOutput(true); DataOutputStream wr = new DataOutputStream(con.getOutputStream()); wr.writeBytes(urlParameters); wr.flush(); wr.close(); int responseCode = con.getResponseCode(); System.out.println("\nSending 'POST' request to URL : " + url); System.out.println("Post parameters : " + urlParameters); System.out.println("Response Code : " + responseCode); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); //print result System.out.println(response.toString()); } } </pre> </div> <div> <h4>.NET</h4> <pre class="brush: java;"> public static void Main(string[] args) { var request = (HttpWebRequest)WebRequest.Create("https://api.iban.com/clients/api/banksuite/bic/"); var postData = "api_key=[YOUR_API_KEY]"; postData += "&format=json"; postData += "&bic=BARCGB22XXX"; var data = Encoding.ASCII.GetBytes(postData); request.Method = "POST"; request.ContentType = "application/x-www-form-urlencoded"; request.ContentLength = data.Length; using (var stream = request.GetRequestStream()) { stream.Write(data, 0, data.Length); } var response = (HttpWebResponse)request.GetResponse(); var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd(); Console.WriteLine(responseString); Console.Write("Press any key to continue . . . "); Console.ReadKey(true); } </pre> </div> <div> <h4>NODE</h4> <pre class="brush: java;"> var request = require('request'); var headers = { 'User-Agent': 'IBAN API Client/0.0.1', 'Content-Type': 'application/x-www-form-urlencoded' } var options = { url: 'https://api.iban.com/clients/api/banksuite/bic/', method: 'POST', headers: headers, form: {'api_key': '[YOUR_API_KEY]', 'format': 'json', 'bic': 'BARCGB22XXX'} } request(options, function (error, response, body) { if (!error && response.statusCode == 200) { var data = JSON.parse(body); console.log(data.error); console.log("Query Status: " + data.success); console.log("Bank Code Valid: " + data.bic_valid); console.log("Bank Name: " + data.directory_results.institution_name); console.log("Bank BIC: " + data.directory_results.bic); } }) </pre> </div> </div> </div><br> An example usage of the BankSuite API with a GET request can be:<br><br> <a class="green" href="https://api.iban.com/clients/api/banksuite/bic/?format=json&api_key=[API_KEY]&bic=BARCGB22XXX" target="_new">https://api.iban.com/clients/api/banksuite/bic/?format=json&api_key=[API_KEY]&bic=BARCGB22XXX</a><br><br> Where:<br> <ul class="flat-list style1"> <li>key is your API key</li> <li>BIC code sent for validation by the API module.</li> <li>xml is the response format. Also a json keyword can be specified for json formatted response.</li> </ul><br> Once an HTTP GET or POST request is made with the correct API key, the system will return the results in the specified format. <br> </div> <hr> <div id="section51" class="item"> <h4>5.1 BIC API Output</h4> An XSD Schema of the API’s response can be found below:<br> XSD Schema for BIC endpoint: <a href="https://www.iban.com/files/banksuite/bic.xsd"> download </a><br> <br> <br> The API results are delivered in JSON or XML format for maximum usability. Find below descriptions for the JSON properties returned by the API:<br> <br> <table class="table table-bordered examples"> <thead> <tr> <th>Object</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>QUERY</td> <td>Array</td> <td>Contains the user supplied input parameters.</td> </tr> <tr> <td>SUCCESS</td> <td>Boolean</td> <td>Indicates a true or false indicating if the query succeeded</td> </tr> <tr> <td>BIC_VALID</td> <td>Boolean</td> <td>True or False. Indicates if the submitted BIC have passed all validations</td> </tr> <tr> <td>RECORDS_FOUND</td> <td>Integer</td> <td>Indicates the number of records found in the bank directory. If more than one, you may use the 'limit' parameter to retrieve multiple records for the same bank code</td> </tr> <tr> <td>RECORDS_DISPLAYED</td> <td>Integer</td> <td>Indicates the number of records displayed in the 'directory_results' object. By default we display one record. With the 'limit' parameter, you can retrieve multiple</td> </tr> <tr> <td>DIRECTORY_RESULTS</td> <td>Array</td> <td>This object contains the data retrieved from our bank directory for the respective bank code. You may find a detailed description of this object in <a href="">Section 7 Data Field Definitions</a></td> </tr> <tr> <td>ERROR</td> <td>Object</td> <td>Provides error code and description if an error occurs. For descriptions, please refer to <a href="#section52">Section 5.2 BIC API Errors</a></td> </tr> </tbody> </table> <br> <br> A sample JSON reply from the API for a IBAN validation query would be:<br> <pre class="brush: js;"> { "query": { "bic": "CHASUS33CON" }, "success": true, "bic_valid": true, "records_found": "1", "records_displayed": 1, "directory_results": [ { "office_type": "DB", "legal_type": "B", "institution_status": "BANK", "iso_lei_code": "", "bic8": "CHASUS33", "branch_bic": "CON", "bic": "CHASUS33CON", "chips_uid": "", "national_id": "", "connected_bic": "CHASUS33CON", "institution_name": "JPMORGAN CHASE BANK, N.A.", "branch_information": "", "pob_number": "", "street_address_1": "", "street_address_2": "", "street_address_3": "", "street_address_4": "", "city": "NEW YORK", "cps": "NY", "zip_code": "", "country_name": "UNITED STATES OF AMERICA", "iso_country_code": "US", "subtype_indicator": "SUPE", "network_connectivity": "CNN", "service_codes": "EB+FIN" } ] } </pre> </div> <hr> <div id="section52" class="item"> <br> <h4>5.2 BIC API Errors</h4> We utilize two types of errors for this endpoint.<br> "Query Failed" error indicates that validations were not carried out.<br> "Validation failed" error indicates that the bank code or account number submitted has failed a validation step.<br> <br> <table class="table table-bordered downloads"> <thead> <tr> <th>Error Code</th> <th>HTTP Status Code</th> <th>Type</th> <th>Message</th> </tr> </thead> <tbody> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>301</td><td>403</td><td>Query failed</td><td>API Key is invalid</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>305</td><td>403</td><td>Query failed</td><td>IP Address not allowed</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>304</td><td>403</td><td>Query failed</td><td>You have no access to this API</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>302</td><td>403</td><td>Query failed</td><td>Subscription expired</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>303</td><td>403</td><td>Query failed</td><td>No queries available</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>306</td><td>400</td><td>Query failed</td><td>Bad Request. Required minimum parameters: api_key; format; iso; nid</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>806</td><td>400</td><td>Query failed</td><td>Invalid value for 'limit' parameter</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>500</td><td>500</td><td>Query failed</td><td>Internal Server Error</td></tr> <tr style="background-color: #fefae2;"><td>807</td><td>200</td><td>Validation failed</td><td>Invalid Characters in BIC</td></tr> <tr style="background-color: #fefae2;"><td>808</td><td>200</td><td>Validation failed</td><td>BIC length is not correct. BIC code must be 8 or 11 characters long</td></tr> <tr style="background-color: #fefae2;"><td>400</td><td>200</td><td>Validation failed</td><td>BIC not found in official directory</td></tr> </tbody> </table> </div>       <div id="section6" class="item"> <h4>6. STRUCTURE API Input</h4> The Structure endpoint is designed to provide bank code formatting information for a specified country code.<br> The input parameters are listed in the table below:<br><br> <table class="table table-bordered examples"> <thead> <tr> <th width="189">Field Name</th> <th width="103">Length</th> <th width="69">Type</th> <th width="487">Description</th> </tr> </thead> <tbody> <tr> <td width="189">country_iso</td> <td width="103">2</td> <td width="69">String</td> <td width="487">The 2 letter ISO country code submitted by the client</td> </tr> <tr> <td width="189">api_key</td> <td width="103">128</td> <td width="69">String</td> <td width="487">Your personal API key.</td> </tr> <tr> <td width="189">format</td> <td width="103">5</td> <td width="69">String</td> <td width="487">Format of the response XML and JSON supported.</td> </tr> </tbody> </table> <br> *To obtain an API key, please contact us at <a href="mailto:contact@iban.com">contact@iban.com</a> or purchase a subscription at our <a href="pricing"> order page </a> <br><br> <strong>EXAMPLE – Retrieve Bank Code and Account Number format and structure for a specified country </strong><br> Feel free to use the sample code below to integrate the API in the most common programming languages.<br> <br> <div id="tabbed-nav3"> <ul> <li><a>CURL</a></li> <li><a>PHP</a></li> <li><a>RUBY</a></li> <li><a>PYTHON</a></li> <li><a>Perl</a></li> <li><a>JAVA</a></li> <li><a>.NET</a></li> <li><a>NODE</a></li> </ul> <div> <div> <pre class="brush: bash;"> curl "https://api.iban.com/clients/api/banksuite/structure/" \ -X POST \ -d format=json \ -d api_key=[YOUR_API_KEY] \ -d country_iso=US </pre> </div> <div> <pre class="brush: php;"> <?php $curl = curl_init(); $post = [ 'format' => 'json', 'api_key' => '[YOUR_API_KEY]', 'country_iso' => 'US', ]; curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.iban.com/clients/api/banksuite/structure/', CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $post )); $output = curl_exec($curl); $result = json_decode($output); print_r($result); curl_close($curl); ?> </pre> </div> <div> <pre class="brush: php;"> require 'net/http' uri = URI('https://api.iban.com/clients/api/banksuite/') res = Net::HTTP.post_form(uri, "format" => "json", "api_key" => "[YOUR_API_KEY]","country_iso" => "US") puts res.body </pre> </div> <div> <pre class="brush: php;"> import requests post_data = {'format':'json', 'api_key':'[YOUR_API_KEY]','country_iso':'US'} response = requests.post('https://api.iban.com/clients/api/banksuite/structure/',post_data) print(response.text) </pre> </div> <div> <pre class="brush: php;"> use LWP::UserAgent; my $ua = LWP::UserAgent->new; my $server_endpoint = "https://api.iban.com/clients/api/banksuite/structure/"; my $format = 'json'; my $api_key = '[YOUR_API_KEY]'; my $country_iso = 'US'; my $req = HTTP::Request->new( POST => $server_endpoint ); $req->content_type('application/x-www-form-urlencoded'); my $post_data = 'format=' . $format . '&api_key=' . $api_key . '&country_iso=' . $country_iso ; $req->content($post_data); my $resp = $ua->request($req); if ( $resp->is_success ) { my $message = $resp->decoded_content; print $message; } </pre> </div> <div> <h4>JAVA</h4> <pre class="brush: csharp;"> import java.io.BufferedReader; import java.io.DataOutputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import javax.net.ssl.HttpsURLConnection; import org.json.simple.JSONObject; import org.json.simple.JSONArray; import org.json.simple.parser.ParseException; import org.json.simple.parser.JSONParser; public class ibanapi { private final String USER_AGENT = "API Client/1.0"; public static void main(String[] args) throws Exception { ibanapi http = new ibanapi(); System.out.println("\nTesting API - Send API POST request"); http.sendPost(); } // HTTP POST request private void sendPost() throws Exception { String url = "https://api.iban.com/clients/api/banksuite/structure/"; URL obj = new URL(url); HttpsURLConnection con = (HttpsURLConnection) obj.openConnection(); //add reuqest header con.setRequestMethod("POST"); con.setRequestProperty("User-Agent", USER_AGENT); con.setRequestProperty("Accept-Language", "en-US,en;q=0.5"); String urlParameters = "api_key=[YOUR_API_KEY]&format=json&country_iso=US"; // Send post request con.setDoOutput(true); DataOutputStream wr = new DataOutputStream(con.getOutputStream()); wr.writeBytes(urlParameters); wr.flush(); wr.close(); int responseCode = con.getResponseCode(); System.out.println("\nSending 'POST' request to URL : " + url); System.out.println("Post parameters : " + urlParameters); System.out.println("Response Code : " + responseCode); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); //print result System.out.println(response.toString()); } } </pre> </div> <div> <h4>.NET</h4> <pre class="brush: java;"> public static void Main(string[] args) { var request = (HttpWebRequest)WebRequest.Create("https://api.iban.com/clients/api/banksuite/structure/"); var postData = "api_key=[YOUR_API_KEY]"; postData += "&format=json"; postData += "&country_iso=US"; var data = Encoding.ASCII.GetBytes(postData); request.Method = "POST"; request.ContentType = "application/x-www-form-urlencoded"; request.ContentLength = data.Length; using (var stream = request.GetRequestStream()) { stream.Write(data, 0, data.Length); } var response = (HttpWebResponse)request.GetResponse(); var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd(); Console.WriteLine(responseString); Console.Write("Press any key to continue . . . "); Console.ReadKey(true); } </pre> </div> <div> <h4>NODE</h4> <pre class="brush: java;"> var request = require('request'); var headers = { 'User-Agent': 'IBAN API Client/0.0.1', 'Content-Type': 'application/x-www-form-urlencoded' } var options = { url: 'https://api.iban.com/clients/api/banksuite/structure/', method: 'POST', headers: headers, form: {'api_key': '[YOUR_API_KEY]', 'format': 'json', 'country_iso': 'US'} } request(options, function (error, response, body) { if (!error && response.statusCode == 200) { var data = JSON.parse(body); console.log(data.error); console.log("Query Status: " + data.success); console.log("Bank Code Valid: " + data.national_id_format.LENGTH); } }) </pre> </div> </div> </div><br> An example usage of the BankSuite API with a GET request can be:<br><br> <a class="green" href="https://api.iban.com/clients/api/banksuite/structure/?format=json&api_key=[API_KEY]&country_iso=GB" target="_new">https://api.iban.com/clients/api/banksuite/structure/?format=json&api_key=[API_KEY]&country_iso=GB</a><br><br> Where:<br> <ul class="flat-list style1"> <li>key is your API key</li> <li>country_iso is the 2 letter ISO country code you need the formatting data for.</li> <li>xml is the response format. Also a json keyword can be specified for json formatted response.</li> </ul><br> Once an HTTP GET or POST request is made with the correct API key, the system will return the results in the specified format. <br> </div> <hr> <div id="section61" class="item"> <h4>6.1 Structure API Output</h4> An XSD Schema of the API’s response can be found below:<br> XSD Schema for Structure endpoint: <a href="https://www.iban.com/files/banksuite/structure.xsd"> download </a><br> <br> <br> The API results are delivered in JSON or XML format for maximum usability. Find below descriptions for the JSON properties returned by the API:<br> <br> <table class="table table-bordered examples"> <thead> <tr> <th>Object</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>success</td> <td>Boolean</td> <td>Indicates a true or false indicating if the query succeeded</td> </tr> <tr> <td>national_id_format</td> <td>Object</td> <td>This object contains data for the format and structure of the Bank Code</td> </tr> <tr> <td>account_number_format</td> <td>Object</td> <td>This object contains information about the structure, length and formatting of the domestic bank account number for the specified country.</td> </tr> <tr> <td>error</td> <td>Object</td> <td>Provides error code and description if an error occurs. For descriptions, please refer to <a href="#section62">Section 6.2 Structure API Errors</a></td> </tr> </tbody> </table> <br> <br> A sample JSON reply from the API for a IBAN validation query would be:<br> <pre class="brush: js;"> { "success": true, "national_id_format": [ { "COUNTRY_CODE": "US", "COUNTRY_NAME": "UNITED STATES OF AMERICA", "NATIONAL_ID_LOCAL_NAME": "Routing Number", "NATIONAL_ID_LOCAL_ACRONYM": "ABA", "CLEARING_SYSTEM": "American Bankers Association (ABA)", "EXAMPLE": "211770093", "LETTER_FORMAT": "BBBBIIIIK", "ELEMENTS": "BANK_CODE,INSTITUTION_CODE,CHECKSUM", "LENGTH": "9", "LENGTH_IN_DB": "9" } ], "account_number_format": [ { "ISO_COUNTRY_CODE": "US", "COUNTRY_NAME": "UNITED STATES OF AMERICA", "ACCOUNT_NB_TYPE": "Account number - Standard", "ACCOUNT_NB_LOCAL_NAME": "Account number", "EXAMPLE": "1000248938", "LETTER_FORMAT": "AAAAAAAAAA", "ELEMENTS": "ACCOUNT", "MIN_LENGTH": "9", "MAX_LENGTH": "10" } ] } </pre> </div> <hr> <div id="section62" class="item"> <br> <h4>6.2 Structure API Errors</h4> The structure endpoint can return any of the following errors:<br> <br> <br> <table class="table table-bordered downloads"> <thead> <tr> <th>Error Code</th> <th>HTTP Status Code</th> <th>Type</th> <th>Message</th> </tr> </thead> <tbody> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>301</td><td>403</td><td>Query failed</td><td>API Key is invalid</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>305</td><td>403</td><td>Query failed</td><td>IP Address not allowed</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>304</td><td>403</td><td>Query failed</td><td>You have no access to this API</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>302</td><td>403</td><td>Query failed</td><td>Subscription expired</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>303</td><td>403</td><td>Query failed</td><td>No queries available</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>306</td><td>400</td><td>Query failed</td><td>Bad Request. Required minimum parameters: api_key; format; iso; nid</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>806</td><td>400</td><td>Query failed</td><td>Invalid value for 'limit' parameter</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>500</td><td>500</td><td>Query failed</td><td>Internal Server Error</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>802</td><td>400</td><td>Query failed</td><td>Country ISO code invalid</td></tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"><td>400</td><td>400</td><td>Query failed</td><td>ISO Country Code not found in registry</td></tr> </tbody> </table> </div>    <div id="section7" class="item"> <br> <h4>7. Data Field Definitions</h4> <br> <div class="alert alert-warning"><br><br>The data field definitions section is only available for licensed users. <br> To purchase a license for the Bank Suite service, please visit our <a href="/pricing"> pricing page</a><br><br><br> </div> </div>  <div id="section8" class="item"> <br> <h4>8. Supported Countries</h4> <div class="register structure"> The table below provides a quick reference of the countries which the Bank Suite service covers.<br> <br> <br> <br> <table class="table table-bordered table-striped downloads tablesorter"> <thead> <tr> <th class="head headerSortDown headerSortUp">ISO</th> <th class="head">Country</th> <th class="head">Account validation</th> <th class="head">Length</th> </tr> </thead> <tbody> <tr><td>AD</td><td>ANDORRA</td><td>n/a</td><td>8</td></tr> <tr><td>AE</td><td>UNITED ARAB EMIRATES</td><td>n/a</td><td>3 and 9</td></tr> <tr><td>AF</td><td>AFGHANISTAN</td><td>n/a</td><td>4</td></tr> <tr><td>AG</td><td>ANTIGUA AND BARBUDA</td><td>n/a</td><td>8</td></tr> <tr><td>AI</td><td>ANGUILLA</td><td>n/a</td><td>8</td></tr> <tr><td>AL</td><td>ALBANIA</td><td>n/a</td><td>8</td></tr> <tr><td>AM</td><td>ARMENIA</td><td>n/a</td><td>5</td></tr> <tr><td>AO</td><td>ANGOLA</td><td>n/a</td><td>8</td></tr> <tr><td>AR</td><td>ARGENTINA</td><td>n/a</td><td>7</td></tr> <tr><td>AS</td><td>AMERICAN SAMOA</td><td>n/a</td><td>9</td></tr> <tr><td>AT</td><td>AUSTRIA</td><td>yes</td><td>5</td></tr> <tr><td>AU</td><td>AUSTRALIA</td><td>n/a</td><td>6</td></tr> <tr><td>AW</td><td>ARUBA</td><td>n/a</td><td>9</td></tr> <tr><td>AZ</td><td>AZERBAIJAN</td><td>n/a</td><td>6 and 12</td></tr> <tr><td>BA</td><td>BOSNIA AND HERZEGOVINA</td><td>yes</td><td>6</td></tr> <tr><td>BD</td><td>BANGLADESH</td><td>n/a</td><td>9</td></tr> <tr><td>BE</td><td>BELGIUM</td><td>yes</td><td>3</td></tr> <tr><td>BF</td><td>BURKINA FASO</td><td>n/a</td><td>5</td></tr> <tr><td>BG</td><td>BULGARIA</td><td>n/a</td><td>8</td></tr> <tr><td>BH</td><td>BAHRAIN</td><td>n/a</td><td>4</td></tr> <tr><td>BJ</td><td>BENIN</td><td>n/a</td><td>5</td></tr> <tr><td>BM</td><td>BERMUDA</td><td>n/a</td><td>2</td></tr> <tr><td>BN</td><td>BRUNEI DARUSSALAM</td><td>n/a</td><td>6</td></tr> <tr><td>BO</td><td>BOLIVIA</td><td>n/a</td><td>5</td></tr> <tr><td>BR</td><td>BRAZIL</td><td>n/a</td><td>7 and 8</td></tr> <tr><td>BS</td><td>BAHAMAS</td><td>n/a</td><td>8</td></tr> <tr><td>BT</td><td>BHUTAN</td><td>n/a</td><td>9</td></tr> <tr><td>BW</td><td>BOTSWANA</td><td>n/a</td><td>6</td></tr> <tr><td>BY</td><td>BELARUS</td><td>n/a</td><td>8 and 11</td></tr> <tr><td>BZ</td><td>BELIZE</td><td>n/a</td><td>8</td></tr> <tr><td>CA</td><td>CANADA</td><td>n/a</td><td>9</td></tr> <tr><td>CF</td><td>CENTRAL AFRICAN REPUBLIC</td><td>n/a</td><td>10</td></tr> <tr><td>CG</td><td>CONGO</td><td>n/a</td><td>10</td></tr> <tr><td>CH</td><td>SWITZERLAND</td><td>yes</td><td>5</td></tr> <tr><td>CI</td><td>COTE D'IVOIRE</td><td>n/a</td><td>5</td></tr> <tr><td>CK</td><td>COOK ISLANDS</td><td>n/a</td><td>6</td></tr> <tr><td>CL</td><td>CHILE</td><td>n/a</td><td>3</td></tr> <tr><td>CM</td><td>CAMEROON</td><td>n/a</td><td>10</td></tr> <tr><td>CN</td><td>CHINA</td><td>n/a</td><td>12</td></tr> <tr><td>CO</td><td>COLOMBIA</td><td>n/a</td><td>2 and 5</td></tr> <tr><td>CR</td><td>COSTA RICA</td><td>yes</td><td>3</td></tr> <tr><td>CV</td><td>CABO VERDE</td><td>n/a</td><td>2 and 8</td></tr> <tr><td>CY</td><td>CYPRUS</td><td>n/a</td><td>8</td></tr> <tr><td>CZ</td><td>CZECHIA</td><td>yes</td><td>4</td></tr> <tr><td>DE</td><td>GERMANY</td><td>yes</td><td>8</td></tr> <tr><td>DK</td><td>DENMARK</td><td>yes</td><td>4</td></tr> <tr><td>DM</td><td>DOMINICA</td><td>n/a</td><td>8</td></tr> <tr><td>DO</td><td>DOMINICAN REPUBLIC</td><td>n/a</td><td>4</td></tr> <tr><td>DZ</td><td>ALGERIA</td><td>n/a</td><td>3</td></tr> <tr><td>EC</td><td>ECUADOR</td><td>n/a</td><td>2 and 8</td></tr> <tr><td>EE</td><td>ESTONIA</td><td>yes</td><td>2</td></tr> <tr><td>ES</td><td>SPAIN</td><td>yes</td><td>9</td></tr> <tr><td>FI</td><td>FINLAND</td><td>yes</td><td>3</td></tr> <tr><td>FJ</td><td>FIJI</td><td>n/a</td><td>6</td></tr> <tr><td>FO</td><td>FAROE ISLANDS</td><td>yes</td><td>4</td></tr> <tr><td>FR</td><td>FRANCE</td><td>yes</td><td>10</td></tr> <tr><td>GA</td><td>GABON</td><td>n/a</td><td>10</td></tr> <tr><td>GB</td><td>UNITED KINGDOM</td><td>yes</td><td>6</td></tr> <tr><td>GD</td><td>GRENADA</td><td>n/a</td><td>8</td></tr> <tr><td>GE</td><td>GEORGIA</td><td>n/a</td><td>2 and 9</td></tr> <tr><td>GF</td><td>FRENCH GUIANA</td><td>yes</td><td>10</td></tr> <tr><td>GG</td><td>GUERNSEY</td><td>yes</td><td>6</td></tr> <tr><td>GH</td><td>GHANA</td><td>n/a</td><td>6</td></tr> <tr><td>GI</td><td>GIBRALTAR</td><td>n/a</td><td>6</td></tr> <tr><td>GL</td><td>GREENLAND</td><td>yes</td><td>4</td></tr> <tr><td>GM</td><td>GAMBIA</td><td>n/a</td><td>6</td></tr> <tr><td>GN</td><td>GUINEA</td><td>n/a</td><td>6</td></tr> <tr><td>GP</td><td>GUADELOUPE</td><td>yes</td><td>10</td></tr> <tr><td>GQ</td><td>EQUATORIAL GUINEA</td><td>n/a</td><td>10</td></tr> <tr><td>GR</td><td>GREECE</td><td>n/a</td><td>7</td></tr> <tr><td>GT</td><td>GUATEMALA</td><td>n/a</td><td>2</td></tr> <tr><td>GU</td><td>GUAM</td><td>n/a</td><td>9</td></tr> <tr><td>GW</td><td>GUINEA-BISSAU</td><td>n/a</td><td>5</td></tr> <tr><td>GY</td><td>GUYANA</td><td>n/a</td><td>8</td></tr> <tr><td>HK</td><td>HONG KONG</td><td>n/a</td><td>6</td></tr> <tr><td>HN</td><td>HONDURAS</td><td>n/a</td><td>6</td></tr> <tr><td>HR</td><td>CROATIA</td><td>yes</td><td>7</td></tr> <tr><td>HT</td><td>HAITI</td><td>n/a</td><td>9</td></tr> <tr><td>HU</td><td>HUNGARY</td><td>yes</td><td>8</td></tr> <tr><td>ID</td><td>INDONESIA</td><td>n/a</td><td>7</td></tr> <tr><td>IE</td><td>IRELAND</td><td>yes</td><td>6</td></tr> <tr><td>IL</td><td>ISRAEL</td><td>yes</td><td>6</td></tr> <tr><td>IM</td><td>ISLE OF MAN</td><td>yes</td><td>6</td></tr> <tr><td>IN</td><td>INDIA</td><td>n/a</td><td>9 and 11</td></tr> <tr><td>IS</td><td>ICELAND</td><td>yes</td><td>4</td></tr> <tr><td>IT</td><td>ITALY</td><td>yes</td><td>10</td></tr> <tr><td>JE</td><td>JERSEY</td><td>yes</td><td>6</td></tr> <tr><td>JM</td><td>JAMAICA</td><td>n/a</td><td>8</td></tr> <tr><td>JO</td><td>JORDAN</td><td>n/a</td><td>2</td></tr> <tr><td>JP</td><td>JAPAN</td><td>n/a</td><td>7</td></tr> <tr><td>KE</td><td>KENYA</td><td>n/a</td><td>5</td></tr> <tr><td>KG</td><td>KYRGYZSTAN</td><td>n/a</td><td>6</td></tr> <tr><td>KH</td><td>CAMBODIA</td><td>n/a</td><td>6</td></tr> <tr><td>KM</td><td>COMOROS</td><td>n/a</td><td>5</td></tr> <tr><td>KN</td><td>SAINT KITTS AND NEVIS</td><td>n/a</td><td>8</td></tr> <tr><td>KR</td><td>REPUBLIC OF KOREA</td><td>n/a</td><td>7</td></tr> <tr><td>KW</td><td>KUWAIT</td><td>n/a</td><td>4</td></tr> <tr><td>KZ</td><td>KAZAKHSTAN</td><td>n/a</td><td>3</td></tr> <tr><td>LB</td><td>LEBANON</td><td>n/a</td><td>4</td></tr> <tr><td>LC</td><td>SAINT LUCIA</td><td>n/a</td><td>8</td></tr> <tr><td>LI</td><td>LIECHTENSTEIN</td><td>yes</td><td>5</td></tr> <tr><td>LK</td><td>SRI LANKA</td><td>n/a</td><td>7</td></tr> <tr><td>LS</td><td>LESOTHO</td><td>n/a</td><td>6</td></tr> <tr><td>LT</td><td>LITHUANIA</td><td>n/a</td><td>5</td></tr> <tr><td>LU</td><td>LUXEMBOURG</td><td>n/a</td><td>3</td></tr> <tr><td>LV</td><td>LATVIA</td><td>n/a</td><td>4</td></tr> <tr><td>MA</td><td>MOROCCO</td><td>yes</td><td>10</td></tr> <tr><td>MC</td><td>MONACO</td><td>yes</td><td>10</td></tr> <tr><td>MD</td><td>MOLDOVA</td><td>n/a</td><td>11</td></tr> <tr><td>ME</td><td>MONTENEGRO</td><td>yes</td><td>3</td></tr> <tr><td>MG</td><td>MADAGASCAR</td><td>n/a</td><td>10</td></tr> <tr><td>MK</td><td>NORTH MACEDONIA</td><td>yes</td><td>3</td></tr> <tr><td>ML</td><td>MALI</td><td>n/a</td><td>5</td></tr> <tr><td>MN</td><td>MONGOLIA</td><td>n/a</td><td>6</td></tr> <tr><td>MO</td><td>MACAO</td><td>n/a</td><td>3</td></tr> <tr><td>MP</td><td>NORTHERN MARIANA ISLANDS</td><td>n/a</td><td>9</td></tr> <tr><td>MQ</td><td>MARTINIQUE</td><td>yes</td><td>10</td></tr> <tr><td>MR</td><td>MAURITANIA</td><td>yes</td><td>10</td></tr> <tr><td>MS</td><td>MONTSERRAT</td><td>n/a</td><td>8</td></tr> <tr><td>MT</td><td>MALTA</td><td>n/a</td><td>5</td></tr> <tr><td>MU</td><td>MAURITIUS</td><td>n/a</td><td>4</td></tr> <tr><td>MW</td><td>MALAWI</td><td>n/a</td><td>6</td></tr> <tr><td>MX</td><td>MEXICO</td><td>n/a</td><td>6</td></tr> <tr><td>MY</td><td>MALAYSIA</td><td>n/a</td><td>4 and 9</td></tr> <tr><td>MZ</td><td>MOZAMBIQUE</td><td>n/a</td><td>2</td></tr> <tr><td>NA</td><td>NAMIBIA</td><td>n/a</td><td>6</td></tr> <tr><td>NC</td><td>NEW CALEDONIA</td><td>yes</td><td>10</td></tr> <tr><td>NE</td><td>NIGER</td><td>n/a</td><td>5</td></tr> <tr><td>NG</td><td>NIGERIA</td><td>n/a</td><td>9</td></tr> <tr><td>NI</td><td>NICARAGUA</td><td>n/a</td><td>2</td></tr> <tr><td>NL</td><td>NETHERLANDS</td><td>yes</td><td>4</td></tr> <tr><td>NO</td><td>NORWAY</td><td>yes</td><td>4</td></tr> <tr><td>NP</td><td>NEPAL</td><td>n/a</td><td>8</td></tr> <tr><td>NZ</td><td>NEW ZEALAND</td><td>n/a</td><td>6</td></tr> <tr><td>PA</td><td>PANAMA</td><td>n/a</td><td>3 and 9</td></tr> <tr><td>PE</td><td>PERU</td><td>n/a</td><td>3</td></tr> <tr><td>PF</td><td>FRENCH POLYNESIA</td><td>yes</td><td>10</td></tr> <tr><td>PG</td><td>PAPUA NEW GUINEA</td><td>n/a</td><td>6</td></tr> <tr><td>PH</td><td>PHILIPPINES</td><td>n/a</td><td>6 and 9</td></tr> <tr><td>PK</td><td>PAKISTAN</td><td>n/a</td><td>7</td></tr> <tr><td>PL</td><td>POLAND</td><td>yes</td><td>8</td></tr> <tr><td>PM</td><td>SAINT PIERRE AND MIQUELON</td><td>yes</td><td>10</td></tr> <tr><td>PR</td><td>PUERTO RICO</td><td>n/a</td><td>9</td></tr> <tr><td>PS</td><td>PALESTINE</td><td>n/a</td><td>2 and 5</td></tr> <tr><td>PT</td><td>PORTUGAL</td><td>yes</td><td>8</td></tr> <tr><td>PY</td><td>PARAGUAY</td><td>n/a</td><td>4 and 7</td></tr> <tr><td>QA</td><td>QATAR</td><td>n/a</td><td>2</td></tr> <tr><td>RE</td><td>REUNION</td><td>yes</td><td>10</td></tr> <tr><td>RO</td><td>ROMANIA</td><td>n/a</td><td>4</td></tr> <tr><td>RS</td><td>SERBIA</td><td>yes</td><td>3</td></tr> <tr><td>RU</td><td>RUSSIAN FEDERATION</td><td>yes</td><td>9</td></tr> <tr><td>RW</td><td>RWANDA</td><td>n/a</td><td>3</td></tr> <tr><td>SA</td><td>SAUDI ARABIA</td><td>n/a</td><td>2</td></tr> <tr><td>SB</td><td>SOLOMON ISLANDS</td><td>n/a</td><td>6</td></tr> <tr><td>SC</td><td>SEYCHELLES</td><td>n/a</td><td>6</td></tr> <tr><td>SE</td><td>SWEDEN</td><td>yes</td><td>4</td></tr> <tr><td>SG</td><td>SINGAPORE</td><td>n/a</td><td>7</td></tr> <tr><td>SI</td><td>SLOVENIA</td><td>yes</td><td>5</td></tr> <tr><td>SK</td><td>SLOVAKIA</td><td>yes</td><td>4</td></tr> <tr><td>SL</td><td>SIERRA LEONE</td><td>n/a</td><td>6</td></tr> <tr><td>SM</td><td>SAN MARINO</td><td>yes</td><td>10</td></tr> <tr><td>SN</td><td>SENEGAL</td><td>n/a</td><td>5</td></tr> <tr><td>ST</td><td>SAO TOME AND PRINCIPE</td><td>n/a</td><td>8</td></tr> <tr><td>SV</td><td>EL SALVADOR</td><td>n/a</td><td>2</td></tr> <tr><td>SZ</td><td>ESWATINI</td><td>n/a</td><td>6</td></tr> <tr><td>TD</td><td>CHAD</td><td>n/a</td><td>10</td></tr> <tr><td>TG</td><td>TOGO</td><td>n/a</td><td>5</td></tr> <tr><td>TH</td><td>THAILAND</td><td>n/a</td><td>7</td></tr> <tr><td>TJ</td><td>TAJIKISTAN</td><td>n/a</td><td>9</td></tr> <tr><td>TL</td><td>TIMOR-LESTE</td><td>yes</td><td>4</td></tr> <tr><td>TN</td><td>TUNISIA</td><td>yes</td><td>5</td></tr> <tr><td>TO</td><td>TONGA</td><td>n/a</td><td>6</td></tr> <tr><td>TR</td><td>TURKEY</td><td>n/a</td><td>9</td></tr> <tr><td>TW</td><td>TAIWAN</td><td>n/a</td><td>7</td></tr> <tr><td>TZ</td><td>TANZANIA</td><td>n/a</td><td>6</td></tr> <tr><td>UA</td><td>UKRAINE</td><td>n/a</td><td>6</td></tr> <tr><td>UG</td><td>UGANDA</td><td>n/a</td><td>6</td></tr> <tr><td>US</td><td>UNITED STATES OF AMERICA</td><td>n/a</td><td>9</td></tr> <tr><td>UY</td><td>URUGUAY</td><td>n/a</td><td>3</td></tr> <tr><td>UZ</td><td>UZBEKISTAN</td><td>n/a</td><td>5</td></tr> <tr><td>VA</td><td>HOLY SEE</td><td>n/a</td><td>3</td></tr> <tr><td>VC</td><td>SAINT VINCENT AND THE GRENADINES</td><td>n/a</td><td>8</td></tr> <tr><td>VE</td><td>VENEZUELA (BOLIVARIAN REPUBLIC OF)</td><td>n/a</td><td>4</td></tr> <tr><td>VI</td><td>VIRGIN ISLANDS (U.S.)</td><td>n/a</td><td>9</td></tr> <tr><td>VN</td><td>VIET NAM</td><td>n/a</td><td>8</td></tr> <tr><td>VU</td><td>VANUATU</td><td>n/a</td><td>6</td></tr> <tr><td>WF</td><td>WALLIS AND FUTUNA</td><td>yes</td><td>10</td></tr> <tr><td>WS</td><td>SAMOA</td><td>n/a</td><td>6</td></tr> <tr><td>XK</td><td>REPUBLIC OF KOSOVO</td><td>yes</td><td>4</td></tr> <tr><td>YT</td><td>MAYOTTE</td><td>yes</td><td>10</td></tr> <tr><td>ZA</td><td>SOUTH AFRICA</td><td>n/a</td><td>6</td></tr> <tr><td>ZM</td><td>ZAMBIA</td><td>n/a</td><td>6</td></tr> <tr><td>ZW</td><td>ZIMBABWE</td><td>n/a</td><td>5</td></tr> </tbody></table> </div> </div> </div> </div> </div> </div></div></div> <footer class="footer" > <div class="footer-widgets"> <div class="container"> <div class="row"> <div class="col-lg-3 col-md-6 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle">Web Tools</div> <ul class="ft-menu"> <li><a href="/iban-checker">IBAN Checker</a></li> <li><a href="/calculate-iban">IBAN Calculator</a></li> <li><a href="/search-bic">Search BIC</a></li> <li><a href="/vat-checker">VAT Checker</a></li> <li><a href="/currency-converter">Currency Convert</a></li> <li><a href="/exchange-rates">Currency Exchange rates</a></li> </ul> </div> </div> </div> <div class="col-lg-3 col-md-6 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/developers">Products</a></div> <ul class="ft-menu"> <li><a href="/iban-suite">IBAN Suite: Validation & Calculation</a></li> <li><a href="/bank-suite">Bank Suite: Global Banking Validation</a></li> <li><a href="/bic-validation-service">BIC Validation Service</a></li> <li><a href="/sortware">SortWare: Web Portal & Rest API</a></li> <li><a href="/forex-reference-suite">Forex Reference Suite</a></li> </ul> </div> </div> </div> <div class="col-lg-3 col-md-6 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/developers">Developers</a></div> <ul class="ft-menu"> <li><a href="/validation-api">IBAN Validation API</a></li> <li><a href="/calculation-api">IBAN Calculation API</a></li> <li><a href="/bank-suite-api">Bank Suite API</a></li> <li><a href="/bic-validation-api">BIC Validation API</a></li> <li><a href="/sortware-api">SortWare Rest API</a></li>  </ul> </div> </div> </div> <div class="col-lg-3 col-md-6 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/about">About</a></div> <ul class="ft-menu"> <li><a href="/why-iban">Why IBAN</a></li> <li><a href="/security">Security</a></li> <li><a href="/customers">Customers</a></li> <li><a href="/our-data">Our Data</a></li> <li><a href="/news">News & Updates</a></li> </ul> </div> </div> </div> </div></div></div> <div class="content-bottom-widgets"> <div class="container"> <div class="ft-wrapper"> <div class="col-md-12 text-center footermenutitle">Partners</div></div> </div> </div> <div class="content-bottom-widgets"> <div class="container"> <div class="row"> <div class="col-md-4 text-left"> <span style="clear:both;">BIC data used with permission of S.W.I.F.T. SCRL. Database Rights Reserved, 2025. <br> IBAN.com is an authorized VocaLink™ Distributor</span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/swiftref.png" alt="S.W.I.F.T. SCRL" width="155" height="178" >  </span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/deutsche_bundesbank.png" alt="Deutsche Bundesbank" width="155" height="178">  </span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/banque_de_france.png" alt="La Banque de France Eurosisteme" width="155" height="178"></span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/vocalink_mastercard.png" alt="Vocalink LTD (Mastercard)" width="155" height="178">  </span> </div> </div> </div> </div> <div class="footer-content"> <div class="copyright"> <div class="container"> <div class="row"> <div class="col-md-3 col-sm-12 col-xs-12"> Copyright © 2025 IBAN.COM </div> <div class="col-md-8 col-sm-12 col-xs-12"> <a href="/privacy">Privacy</a> <a href="/terms">Terms</a> <a href="/dpa">DPA</a> <a href="/sla" class="d-none d-sm-inline-block">SLA</a> <a href="/security" class="d-none d-sm-inline-block">Security</a> <a href="/contact">Contact</a> <a href="/sitemap" class="d-none d-sm-inline-block" >Sitemap</a> </div> </div> </div> </div> </div> </footer> <a href="#" class="go-top" aria-label="go to top"><i class="fa fa-chevron-up"></i></a> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js" integrity="sha512-bLT0Qm9VnAYZDflyKcBaQ2gg0hSYNQrJ8RilYldYQ1FxQYoCLtUjuuRuZo+fjqhx/qtq/1itJ0C2ejDxltZVFg==" crossorigin="anonymous"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.5.3/js/bootstrap.min.js" integrity="sha512-8qmis31OQi6hIRgvkht0s6mCOittjMa9GMqtK9hes5iEQBQE/Ca6yGE5FsW36vyipGoWQswBj/QBm2JR086Rkw==" crossorigin="anonymous"></script> <script type="text/javascript" src="/javascript/main.js"></script> <link href="https://fonts.googleapis.com/css2?family=Hind+Siliguri:wght@400;700&display=swap" rel="stylesheet"> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-migrate/3.3.2/jquery-migrate.min.js"></script><script type="text/javascript" src="javascript/zozo.tabs.min.js"></script><link rel="stylesheet" type="text/css" href="stylesheets/zozo.tabs.min.css"><script src="javascript/jquery.tablesorter.min.js"></script> <script> $(document).ready(function() { $("table").tablesorter({ sortList: [[0,0],[0,1]], textExtraction:function(s){ if($(s).find('img').length == 0) return $(s).text(); return $(s).find('img').attr('alt'); } }); } ); /*var navItems = jQuery('.menu-item a'); var win = jQuery(window); var items = jQuery('.item'); navItems.click(function(e){ var item = jQuery(this); jQuery('.menu-item a.active').removeClass('active'); item.addClass('active'); }); win.scroll(function(e){ jQuery.each(items, function(key, value){ var item = jQuery(value); console.log(win.scrollTop(), item.offset().top); if(win.scrollTop() >= item.offset().top){ jQuery('.menu-item a.active').removeClass('active'); var id = item.attr('id'); jQuery.each(navItems, function(key, value){ var navItem = jQuery(value); if(navItem.attr('href') == '#'+id) navItem.addClass('active'); }); } }); });*/ </script> <script> jQuery(document).ready(function ($) { /* jQuery activation and setting options for first tabs, enabling multiline*/ $("#tabbed-nav").zozoTabs({ position: "top-compact", multiline: true, theme: "white", shadows: true, orientation: "horizontal", size: "medium", animation: { easing: "easeInOutExpo", duration: 500, effects: "slideH" } }); $("#tabbed-nav2").zozoTabs({ position: "top-compact", multiline: true, theme: "white", shadows: true, orientation: "horizontal", size: "medium", animation: { easing: "easeInOutExpo", duration: 500, effects: "slideH" } }); $("#tabbed-nav3").zozoTabs({ position: "top-compact", multiline: true, theme: "white", shadows: true, orientation: "horizontal", size: "medium", animation: { easing: "easeInOutExpo", duration: 500, effects: "slideH" } }); /* jQuery activation and setting options for second tabs, enabling multiline*/ }); </script>   <script> //divascookies $.DivasCookies({ bannerText : "This website uses cookies in order to improve your web experience. ", // text for the Divas Cookies banner cookiePolicyLink : "/privacy", // link to the extended cookie policy cookiePolicyLinkText : "Privacy policy", // text for the link to the extended cookie policy thirdPartyPolicyWidget : "", // if set to "iubenda" tries to use the Iubenda widget acceptButtonText : "Accept", // text for the close button acceptButtonSrc : "", // source for the close button image openEffect : "", // opening effect for Divas Cookies banner ["fade", "slideUp", "slideDown", "slideLeft", "slideRight"] openEffectDuration : 600, // duration of the opening effect (msec) openEffectEasing : "", // easing for the opening effect closeEffect : "", // closing effect for Divas Cookies banner ["fade", "slideUp", "slideDown", "slideLeft", "slideRight"] closeEffectDuration : 600, // duration of the closing effect (msec) closeEffectEasing : "", // easing for the closing effect debugMode : false, // if true, the options are checked and warnings are shown saveUserPreferences : true, // if true, sets a cookie after the Divas Cookies is closed the first time and never shows it again cookieDuration : 30, // number of days after which the Divas Cookie technical cookie will expire (default 365 days) blockScripts : false, // set this to true if you blocked scripts by wrapping them with if($.DivasCookies.optedIn()){**script to be blocked**} (default false) pageReload : false, // if true reloads the actual page after opt-in to show the previuosly blocked scripts (default false) acceptOnScroll : false, // if true sets the Divas Cookie technical cookie on page scroll for cookies agreement (default false) acceptOnClick : true, // if true sets the Divas Cookie technical cookie on click on any <a> in the page except that on Divas Cookies banner for cookies agreement (default false) excludePolicyPage : true // if true excludes the cookie policy page from acceptOnScroll and acceptOnClick (default false) }); </script>   <script disable-devtool-auto src='https://cdn.jsdelivr.net/npm/disable-devtool@latest'></script> </body> </html>