Function supported_countries

Example:supported_countries("IBAN AND some_BICs AND (account_validated OR bankcode_validated)", "DE", "benutzername", "passwort") returns, in German ("DE"), a list of countries which are supported by the SOAP interface such that IBANs can be calculated, BICs (possible more than one BIC candidate) are returned for those bank codes for which a BIC is defined, and the domestic account number or the bank code are validated (or both).

Purpose: Informs which countries are currently supported by the SOAP interface, and what their names are in a given language. You may specify what conditions must be met for a country to be considered "supported".

Input Parameters:

supported_condition: xsd:stringYour definition of "supported", that is, a condition which countries must meet to be listed. You may use the following keywords, and you can combine them with parentheses, AND, and OR:

IBAN: IBANs can be calculatede for this country.

unique_BIC: returns a unique BIC for any bank code for which a BIC is defined.

some_BICs: returns one or more BIC candidates for any bank code for which a BIC is defined. If more than one BIC candidate is returned, you need to find out yourself which one to use. However, the most likely one will be listed first. Countries which fulfil not just the condition some_BICs but even the condition unique_BIC are considered to also fulfil some_BICs.

name_based_BICs: like for "some_BICs", none, one, or several BIC codes could be returned. However, unlike "some_BICs", these BIC candidates are not taken directly from a directory that maps bank codes to BICs, but they have been determined by joining two directories based on the bank names. This makes the BIC information slightly less reliable. Countries which fulfil "some_BICs" are also considered to fulfil "name_based_BICs". That is, if you require that at least "name_based_BICs" is fulfilled, you will not exclude the better-supported countries fulfilling "some_BICs" or "unique_BIC".

account_validated: for all domestic account numbers which contain a check sum, this check sum is validated.

bankcode_validated: the bank code is validated by looking it up in a directory of bank codes.

If you leave the parameter "supported_condition" empty, the default condition "IBAN AND some_BICs AND (account_validated OR bankcode_validated)" is used.

language: xsd:stringThe two-letter country code for the desired language (for the list of country names); instead of the two-letter code, you may also use a number from this list:

English = 0 or EN

German = 1 or DE

Dutch = 3 or NL

Polish = 4 or PL

French = 5 or FR

Spanish = 6 or ES

Italian = 7 or IT

Turkish = 8 or TR

Croatian = 9 or HR

Serbian = 10 or RS

user: xsd:stringThe user name with which you log in to iban-bic.com.

password: xsd:stringYour password.

Output Fields:

tns:CountryResStruct with the following fields:

result: 'OK' or an error message.

supported_countries: List of 2-letter country codes for all supported countries.

This function in action

Our CMS composes the following table by using several calls of the function "supported_countries". Therefore, we don't have to manually adjust the table; it always keeps up to date automatically whenever the SOAP interface starts supporting another country.

Country

domestic account number validation?

bank code validation?

BICs available?

Albania

no

yes

yes¹

Andorra

no

yes

yes¹

Austria

yes

yes

yes¹

Belarus

no

yes

yes¹

Belgium

yes

yes

yes¹

Bosnia and Herzegovina

yes

yes

yes¹

Bulgaria

no

yes

yes¹

Croatia

yes

yes

yes¹

Czech Republic

yes

yes

yes¹

Denmark

no

yes

yes¹

Estonia

yes

yes

yes¹

Finland

yes

yes

yes¹

France

yes

yes

yes¹

Georgia

no

yes

yes¹

Germany

yes

yes

yes¹

Hungary

yes

yes

yes¹

Ireland

yes

yes

yes³

Israel

no

yes

yes¹

Italy

yes

yes

yes³

Jordan

no

yes

yes¹

Kazakhstan

no

yes

yes¹

Kosovo

yes

yes

yes¹

Latvia

no

yes

yes¹

Lebanon

no

yes

yes¹

Liechtenstein

yes

yes

yes¹

Lithuania

no

yes

yes¹

Luxembourg

no

yes

yes¹

Malta

no

yes

yes¹

Moldova

no

yes

yes¹

Monaco

yes

yes

yes¹

Netherlands

yes

no

yes

Norway

yes

yes

yes¹

Poland

no

yes

yes²

Portugal

yes

yes

yes³

Romania

no

yes

yes¹

San Marino

yes

yes

yes³

Serbia

yes

yes

yes¹

Slovakia

yes

yes

yes¹

Slovenia

yes

yes

yes¹

Spain

yes

yes

yes¹

Sweden

yes

yes

yes¹

Switzerland

yes

yes

yes¹

Turkey

no

yes

yes¹

United Arab Emirates

no

yes

yes¹

United Kingdom

yes

yes

yes¹

¹ These BICs are regularly copied from an official directory (usually from the national bank). If a BIC is defined for some bank code, we will return this one unique BIC.

² These BICs are also regularly copied from an official directory. However, there are bank codes for which more than one BIC is defined. In such a case, we return all possible BIC candidates, so you might have to figure out which one is the correct one.

³ These BICs are regularly updated by combining two official directories, one with BICs and bank names, and another one with bank names and bank codes. We join these directories based on the bank names. Some occasional errors might occur as a result due to naming inconsistencies. Also, the BICs are not always unique, and you might need to determine which one out of several candidates is correct.

Whenever we return several BIC candidates, we always first return short ones (with 8 instead of 11 significant digits). Usually these shorter BICs are good candidates.