DE ♦ EN

IBAN-BIC.com (Theano GmbH)  » Web Service  » Documentation  » Documentation: supported_countries

Forgot password?

Contact
us

New customer? Register

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:string
    Your 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:string
    The 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:string
    The user name with which you log in to iban-bic.com.
  • password: xsd:string
    Your 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.
  • country_names: List of the supported countries' names (in the specified language).
  • balance: Your account balance (number of remaining transactions).

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.

Land Worden binnenlandse rekeningnummers gevalideerd? Worden banknummers gevalideerd? Zijn BICs beschikbaar?
nee ja ja¹
Albanië nee ja ja¹
Andorra nee ja ja¹
België ja ja ja¹
Bosnië en Herzegovina ja ja ja¹
Bulgarije nee ja ja¹
Cyprus nee ja ja¹
Denemarken nee ja ja¹
Duitsland ja ja ja¹
Egypte nee ja ja¹
Estland ja ja ja¹
Finland ja ja ja¹
Frankrijk ja ja ja¹
Georgië nee ja ja¹
Griekenland nee ja ja¹
Groot-Brittannië ja ja ja¹
Hongarije ja ja ja¹
Ierland ja ja ja³
Israël nee ja ja¹
Italië ja ja ja³
Jordanië nee ja ja¹
Kazachstan nee ja ja¹
Kosovo ja ja ja¹
Kroatië ja ja ja¹
Letland nee ja ja¹
Libanon nee ja ja¹
Liechtenstein ja ja ja¹
Litouwen nee ja ja¹
Luxemburg nee ja ja¹
Malta nee ja ja¹
Moldavië nee ja ja¹
Monaco ja ja ja¹
Nederland ja nee ja
Noorwegen ja ja ja¹
Oostenrijk ja ja ja¹
Polen nee ja ja²
Portugal ja ja ja³
Roumenië nee ja ja¹
San Marino ja ja ja³
Servië ja ja ja¹
Slovenië ja ja ja¹
Slowakije ja ja ja¹
Spanje ja ja ja¹
Tsjechië ja ja ja¹
Turkije nee ja ja¹
Verenigde Arabische Emiraten nee ja ja¹
Wit-Rusland nee ja ja¹
Zweden ja ja ja¹
Zwitserland ja ja ja¹

¹ 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.