IBAN_Calculator
View the WSDL for the service. Click on an operation name to view its details.
- validate_iban
- calculate_iban
Close
Name: validate_iban
Binding: IBAN_CalculatorBinding
Endpoint: http://pl.ibancalculator.com/soap_noarrays/index.php
SoapAction: http://pl.ibancalculator.com/soap_noarrays/index.php#validate_iban
Style: document
Input:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: validate_ibanRequest
parts:
parameters: tns:validate_iban
Output:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: validate_ibanResponse
parts:
parameters: tns:validate_ibanResponse
Namespace: urn:IBAN_Calculator
Transport: http://schemas.xmlsoap.org/soap/http
Documentation: Validates the given IBAN. The user ID and password you need to pass with the request are the same you use for logging in as a premium user. This service is available to all premium users who have paid their subscription fee. For more details on the subscription model, see www.iban-bic.com.
Output fields are:
iban: the IBAN that was validated.
result: 'passed' or 'failed' - for a valid or invalid IBAN
checks: this field is removed in this simplified service. The more complete version returns an array of the checks performed (can contain elements such as 'length', 'bank_code', 'account_number', 'iban_checksum').
bic_candidates: this field is removed in this simplified service. The more complete version returns an array of BICs that are associated with the given national bank code. May be empty or may contain one or more elements. The BICstruct element has the attributes bic, wwwcount, sampleurl, and city. If a wwwcount greater than zero is given, the BIC was harvested from the Web (and found on as many pages as indicated by wwwcount, for example at the URL given by sampleurl). If wwwcount is zero, the BIC comes from a national bank or the ECB. If city is given, this also indicates that the BIC comes from a national bank or the ECB. The given city does not necessarily reflect the location of the given branch - it can also be the location of the headquarters.
country: the ISO country code (first two letters of the IBAN)
bank_code: the national bank code. Part of the BIC for NL (where no national bank code exists).
bank: bank name, if known
bank_address: some address data, if known
bank_url: URL of website, if known
branch: branch name, if known
branch_code: branch code, if known
account_number: the national bank account number
account_validation_method: name of the validation algorithm for the national account number
account_validation: for German or Swiss account numbers, an explanation (in German)
length_check: 'passed' or 'failed' - for the right number of characters for the given country
account_check (not provided for every country): 'passed' or 'failed' (checksum validation; if the algorithm is unknown, or if there is no checksum, the result is 'passed' or empty).
bank_code_check (not provided for every country): lookup of national bank code was successful ('passed') or not ('failed')
iban_checksum_check: 'passed' or 'failed' (correctness of the two digits right after the country code in the IBAN)
data_age (not given for all countries): age of the BIC and other bank-related data (not defined for data harvested from the Web). Format: yyyymmdd.
IBANformat: a string describing the IBAN format for the given country, for example: 'DEkk BBBB BBBB CCCC CCCC CC'.
formatcomment: an explanation of the IBANformat string, for example: 'B = sort code (BLZ), C = account No.'
balance: the number of remaining calculations you can do before having to recharge your account. This does not apply to customers with a subscription which includes an unlimited number of calculations.
Name: validate_iban
Binding: IBAN_CalculatorBinding
Endpoint: http://pl.ibancalculator.com/soap_noarrays/index.php
SoapAction: http://pl.ibancalculator.com/soap_noarrays/index.php#validate_iban
Style: document
Input:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: validate_ibanRequest
parts:
parameters: tns:validate_iban
Output:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: validate_ibanResponse
parts:
parameters: tns:validate_ibanResponse
Namespace: urn:IBAN_Calculator
Transport: http://schemas.xmlsoap.org/soap/http
Documentation: Validates the given IBAN. The user ID and password you need to pass with the request are the same you use for logging in as a premium user. This service is available to all premium users who have paid their subscription fee. For more details on the subscription model, see www.iban-bic.com.
Output fields are:
iban: the IBAN that was validated.
result: 'passed' or 'failed' - for a valid or invalid IBAN
checks: this field is removed in this simplified service. The more complete version returns an array of the checks performed (can contain elements such as 'length', 'bank_code', 'account_number', 'iban_checksum').
bic_candidates: this field is removed in this simplified service. The more complete version returns an array of BICs that are associated with the given national bank code. May be empty or may contain one or more elements. The BICstruct element has the attributes bic, wwwcount, sampleurl, and city. If a wwwcount greater than zero is given, the BIC was harvested from the Web (and found on as many pages as indicated by wwwcount, for example at the URL given by sampleurl). If wwwcount is zero, the BIC comes from a national bank or the ECB. If city is given, this also indicates that the BIC comes from a national bank or the ECB. The given city does not necessarily reflect the location of the given branch - it can also be the location of the headquarters.
country: the ISO country code (first two letters of the IBAN)
bank_code: the national bank code. Part of the BIC for NL (where no national bank code exists).
bank: bank name, if known
bank_address: some address data, if known
bank_url: URL of website, if known
branch: branch name, if known
branch_code: branch code, if known
account_number: the national bank account number
account_validation_method: name of the validation algorithm for the national account number
account_validation: for German or Swiss account numbers, an explanation (in German)
length_check: 'passed' or 'failed' - for the right number of characters for the given country
account_check (not provided for every country): 'passed' or 'failed' (checksum validation; if the algorithm is unknown, or if there is no checksum, the result is 'passed' or empty).
bank_code_check (not provided for every country): lookup of national bank code was successful ('passed') or not ('failed')
iban_checksum_check: 'passed' or 'failed' (correctness of the two digits right after the country code in the IBAN)
data_age (not given for all countries): age of the BIC and other bank-related data (not defined for data harvested from the Web). Format: yyyymmdd.
IBANformat: a string describing the IBAN format for the given country, for example: 'DEkk BBBB BBBB CCCC CCCC CC'.
formatcomment: an explanation of the IBANformat string, for example: 'B = sort code (BLZ), C = account No.'
balance: the number of remaining calculations you can do before having to recharge your account. This does not apply to customers with a subscription which includes an unlimited number of calculations.
Close
Name: calculate_iban
Binding: IBAN_CalculatorBinding
Endpoint: http://pl.ibancalculator.com/soap_noarrays/index.php
SoapAction: http://pl.ibancalculator.com/soap_noarrays/index.php#calculate_iban
Style: document
Input:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: calculate_ibanRequest
parts:
parameters: tns:calculate_iban
Output:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: calculate_ibanResponse
parts:
parameters: tns:calculate_ibanResponse
Namespace: urn:IBAN_Calculator
Transport: http://schemas.xmlsoap.org/soap/http
Documentation: Calculates an IBAN for the given national account number. The user ID and password you need to pass with the request are the same you use for logging in as a premium user. This service is available to all premium users who have paid their subscription fee. For more details on the subscription model, see www.iban-bic.com.
Parameters are:
country - the 2-letter ISO country code.
bankcode - The national bank code (BC number for Switzerland). For the following countries, the whole national account number, including any bank codes and branch codes, should be passed with the account parameter, and the bankcode parameter should stay empty: IT, BE, ES, EE, SK, CZ, HU, LU, PL, FR, GR
account - the national account number
user - your unique user ID
password - your password
bic - the BIC (or at least a sufficiently long prefix) for GB, NL (GB: web crawl can be used, but does not provide all BICs. If the bic parameter is omitted, and the BIC is not found in the Web crawl, this will be shown with an error message in the output field result). This parameter is ignored for countries other than GB and NL.
legacy_mode: If set to 1 for Switzerland, the calculator does not use the external Java program provided by Swiss Interbank Clearing. This parameter has no effect for countries other than Switzerland. For Switzerland, the Java program validates account numbers, but is slower and requires all characters to be entered correctly (such as dots, hyphens etc.). The legacy mode is faster, but does not validate account numbers, and is less likely to produce correct results.
Output fields are:
result: 'passed' or 'failed' - for a valid or invalid account number/bank code/country combination
iban: the calculated IBAN (if the national account number/bank code had the right length; an IBAN may be provided even if the account number validation fails.)
checks: this field is removed in this simplified service. The more complete version returns an array of the checks performed (can contain elements such as 'length', 'bank_code', 'account_number').
bic_candidates: this field is removed in this simplified service. The more complete version returns an array of BICs that are associated with the given national bank code. May be empty or may contain one or more elements. The bic element has the attributes bic, wwwcount, sampleurl, and city. If a wwwcount greater than zero is given, the BIC was harvested from the Web (and found on as many pages as indicated by wwwcount, for example on the page indicated by sampleurl). If wwwcount is zero, the BIC comes from a national bank or the ECB. If city is given, this also indicates that the BIC comes from a national bank or the ECB. The given city does not necessarily reflect the location of the given branch - it can also be the location of the headquarters.
country: the ISO country code (first two letters of the IBAN)
bank_code: the national bank code, if it exists. BIC for NL (where no national bank code exists), BC-Nummer for Switzerland. There are functions provided for obtaining Dutch BICs and Swiss BC numbers.
alternative_bank_code: very few banks embed a bank code in the IBAN that is different from the bank code communicated to clients. If this might be the case, this field is filled with the alternative possibility. Otherwise, it is empty.
bank: bank name, if known
bank_address: some address data, if known
bank_url: URL of website, if known
branch: branch name, if known
branch_code: branch code, if known
account_number: the national bank account number
alternative_account_number: sometimes, a subaccount number needs to be appended to a German account number before it is embedded in an IBAN. If this is the case, the extended account number appears in this field.
account_validation_method: name of the validation algorithm for the national account number
account_validation: for German or Swiss account numbers, an explanation (in German)
length_check: 'passed', 'failed for bank code', or 'failed for account number' - for the right number of characters for the given country and account number/bank code
account_check (not provided for every country): 'passed' or 'failed'; for Germany also possible: passed after correction - in that case see alternative_account_number (checksum validation; if the algorithm is unknown, or if there is no checksum, the result is 'passed' or empty).
bank_code_check (not provided for every country): lookup of national bank code was successful ('passed') or not ('failed'); if an alternative bank code might be necessary for the IBAN, this information is added after the word 'passed' in this field.
bic_plausibility_check: NL only. Checks how often account numbers of the given bank actually have the given prefix. Since this does not guarantee anything, this check is ignored for the overall pass/fail decision that is reported in the result field. But for some Dutch banks, it can give you an idea of how likely it is that the right BIC was provided.
data_age (not given for all countries): age of the BIC and other bank-related data (not defined for data harvested from the Web). Format: yyyymmdd.
IBANformat: a string describing the IBAN format for the given country, for example: 'DEkk BBBB BBBB CCCC CCCC CC'.
formatcomment: an explanation of the IBANformat string, for example: 'B = sort code (BLZ), C = account No.'
balance: the number of remaining calculations you can do before having to recharge your account. This does not apply to customers with a subscription which includes an unlimited number of calculations.
Name: calculate_iban
Binding: IBAN_CalculatorBinding
Endpoint: http://pl.ibancalculator.com/soap_noarrays/index.php
SoapAction: http://pl.ibancalculator.com/soap_noarrays/index.php#calculate_iban
Style: document
Input:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: calculate_ibanRequest
parts:
parameters: tns:calculate_iban
Output:
use: literal
namespace: urn:IBAN_Calculator
encodingStyle:
message: calculate_ibanResponse
parts:
parameters: tns:calculate_ibanResponse
Namespace: urn:IBAN_Calculator
Transport: http://schemas.xmlsoap.org/soap/http
Documentation: Calculates an IBAN for the given national account number. The user ID and password you need to pass with the request are the same you use for logging in as a premium user. This service is available to all premium users who have paid their subscription fee. For more details on the subscription model, see www.iban-bic.com.
Parameters are:
country - the 2-letter ISO country code.
bankcode - The national bank code (BC number for Switzerland). For the following countries, the whole national account number, including any bank codes and branch codes, should be passed with the account parameter, and the bankcode parameter should stay empty: IT, BE, ES, EE, SK, CZ, HU, LU, PL, FR, GR
account - the national account number
user - your unique user ID
password - your password
bic - the BIC (or at least a sufficiently long prefix) for GB, NL (GB: web crawl can be used, but does not provide all BICs. If the bic parameter is omitted, and the BIC is not found in the Web crawl, this will be shown with an error message in the output field result). This parameter is ignored for countries other than GB and NL.
legacy_mode: If set to 1 for Switzerland, the calculator does not use the external Java program provided by Swiss Interbank Clearing. This parameter has no effect for countries other than Switzerland. For Switzerland, the Java program validates account numbers, but is slower and requires all characters to be entered correctly (such as dots, hyphens etc.). The legacy mode is faster, but does not validate account numbers, and is less likely to produce correct results.
Output fields are:
result: 'passed' or 'failed' - for a valid or invalid account number/bank code/country combination
iban: the calculated IBAN (if the national account number/bank code had the right length; an IBAN may be provided even if the account number validation fails.)
checks: this field is removed in this simplified service. The more complete version returns an array of the checks performed (can contain elements such as 'length', 'bank_code', 'account_number').
bic_candidates: this field is removed in this simplified service. The more complete version returns an array of BICs that are associated with the given national bank code. May be empty or may contain one or more elements. The bic element has the attributes bic, wwwcount, sampleurl, and city. If a wwwcount greater than zero is given, the BIC was harvested from the Web (and found on as many pages as indicated by wwwcount, for example on the page indicated by sampleurl). If wwwcount is zero, the BIC comes from a national bank or the ECB. If city is given, this also indicates that the BIC comes from a national bank or the ECB. The given city does not necessarily reflect the location of the given branch - it can also be the location of the headquarters.
country: the ISO country code (first two letters of the IBAN)
bank_code: the national bank code, if it exists. BIC for NL (where no national bank code exists), BC-Nummer for Switzerland. There are functions provided for obtaining Dutch BICs and Swiss BC numbers.
alternative_bank_code: very few banks embed a bank code in the IBAN that is different from the bank code communicated to clients. If this might be the case, this field is filled with the alternative possibility. Otherwise, it is empty.
bank: bank name, if known
bank_address: some address data, if known
bank_url: URL of website, if known
branch: branch name, if known
branch_code: branch code, if known
account_number: the national bank account number
alternative_account_number: sometimes, a subaccount number needs to be appended to a German account number before it is embedded in an IBAN. If this is the case, the extended account number appears in this field.
account_validation_method: name of the validation algorithm for the national account number
account_validation: for German or Swiss account numbers, an explanation (in German)
length_check: 'passed', 'failed for bank code', or 'failed for account number' - for the right number of characters for the given country and account number/bank code
account_check (not provided for every country): 'passed' or 'failed'; for Germany also possible: passed after correction - in that case see alternative_account_number (checksum validation; if the algorithm is unknown, or if there is no checksum, the result is 'passed' or empty).
bank_code_check (not provided for every country): lookup of national bank code was successful ('passed') or not ('failed'); if an alternative bank code might be necessary for the IBAN, this information is added after the word 'passed' in this field.
bic_plausibility_check: NL only. Checks how often account numbers of the given bank actually have the given prefix. Since this does not guarantee anything, this check is ignored for the overall pass/fail decision that is reported in the result field. But for some Dutch banks, it can give you an idea of how likely it is that the right BIC was provided.
data_age (not given for all countries): age of the BIC and other bank-related data (not defined for data harvested from the Web). Format: yyyymmdd.
IBANformat: a string describing the IBAN format for the given country, for example: 'DEkk BBBB BBBB CCCC CCCC CC'.
formatcomment: an explanation of the IBANformat string, for example: 'B = sort code (BLZ), C = account No.'
balance: the number of remaining calculations you can do before having to recharge your account. This does not apply to customers with a subscription which includes an unlimited number of calculations.