To validate an IBAN or structured account number like a BBAN (examples of these are CLABE for Mexico or CBU for Argentina), use call 1.01. Call 1.01 is our core call and allows our clients to validate all formats of codes and account numbers.
If you’re just validating a and IBAN or structured account number then just complete the country code, and the account number field in the call. We’ll respond with details of the bank branch.
For example to validate the the German IBAN DE35 1007 0848 0512 1587 00, the details we require are
Country Code: DE
National Id:
Account Number: DE35 1007 0848 0512 1587 00
https://validate.bankersalmanac.com/validate-api/rest/convert/1.0.1?countryCode=DE&nationalId=&accountNumber=DE35 1007 0848 0512 1587 00&token=entertoeknhere&noBranch=N&errorComment=E
What do the optional fields do in the request
These fields are the core fields that you will use. For the request listed above you only need complete the countryCode and nationalId fields. We have a number of optional fields which you can use to tailor the output and are listed below.
| FIELD NAME | DESCRIPTION | FORMAT | MANDATORY or
OPTIONAL |
DEFAULT VALUE |
| countryCode | ISO Country Code | Alpha | Mandatory | |
| nationalId | Domestic bank ID | Alphanumeric | Optional | |
| accountNumber | Domestic Account Number,
BBAN or IBAN |
Alphanumeric | Optional | |
| token | Security token | Alphanumeric & Extended Characters | Optional |
The response for this request can be modified with a number of flags which allow us to give you a response which meets your business requirements.
| FIELD NAME | DESCRIPTION | FORMAT | MANDATORY or
OPTIONAL |
DEFAULT VALUE |
| errorComment | E or S, if the field is set to E then you will be able to
edit the error text in the self service hub |
E or S | Optional | N |
| dataStore | Yes/No flag if you wish the data to be stored for periodic scanning using the | Y or N | Optional | N |
| ref | Free text unique reference for you to use. If this is not completed by you we will respond with a unique reference | Alphanumeric & Extended Characters | Optional | |
| noBranch | Yes/No flag if you do not wish to return the branch details. | Y or N | Optional | Y |
| bic8 | Yes/No flag if you wish any head office with xxx to be returned as a BIC8 or BIC11. Yes if you wish to have a BIC8 (without head office XXX) No or leave blank if you want all BICs returned as BIC11 | Y or N | Optional | N |
| isoAddr | This restricts the field size to the ISO defined 80 characters | Y or N | Optional | N |
| payBranchType | This allows you to choose the branch type from either
I IBAN R Routing P Payment B Branch H Head Office |
I,B,H,R | Optional | P |
| group | The group name that this data should be saved in. Currently not used. | Alphanumeric & Extended Characters | Optional | |
| page | This requests the page number you are after, the default for this is 1 | Numeric | Optional | 1 |
| pageSize | This defines the number of branches on a page, the default is 10 | Numeric | Optional | 10 |
Making the account number mandatory
If you need the account number to be mandatory then please got to the self service hub using the link below.
https://management.bankersalmanac.com/vss-web
Then go to the error module in the bottom left and change the error below to FAIL
08an Account number not entered
Then save the changes and the service will set the account number as mandatory.
Example Output
The recommended fields Tell you what we believe you should be using
Comment and status fields give you the error text and type
Any details on the branch are held within the branch details section.
{
“countryCode”: “DE”,
“nationalId”: “”,
“accountNumber”: “DE35100708480512158700”,
“recommendedNatId”: “”,
“recommendedAcct”: “DE35100708480512158700”,
“recommendedBIC”: “DEUTDEDB110”,
“status”: “PASS”,
“comment”: “”,
“ref”: “20181026131347111”,
“group”: “”,
“branchDetails”: [
{
“bankName”: “DB PRIVAT-UND FIRMENKUNDENBANK AG (FORMERLY DEUTSCHE BANK PGK AG)”,
“branch”: “DB PFK (Deutsche Bank PGK)”,
“street”: “”,
“city”: “BERLIN”,
“postZip”: “”,
“region”: “BERLIN”,
“country”: “GERMANY”,
“codeDetails”: {
“codeName1”: “BIC”,
“codeValue1”: “DEUTDEDB110”,
“codeName2”: “CHIPS”,
“codeValue2”: “”,
“codeName3”: “BIC-4”,
“codeValue3”: “DEUT”,
“codeName4”: “Bankleitzahl BLZ”,
“codeValue4”: “10070848”
},
“sepaDetails”: {
“ctStatus”: “YES”,
“ddStatus”: “YES”,
“bbStatus”: “YES”
},
“additionalData”: {
“ssiAvailable”: “Y”,
“payServiceAvailable”: “Y”,
“contactsAvailable”: “Y”,
“messageAvailable”: “N”,
“holidayAvailable”: “Y”
},
“bankToken”: “EeMfV0GnUZ3ciiAKfFuMJb98tHxWMb2fgiidCtryKbZzN6lmbclWMFLQieie”
}
],
“headOfficeDetails”: {
“bankName”: “DB PRIVAT-UND FIRMENKUNDENBANK AG (FORMERLY DEUTSCHE BANK PGK AG)”,
“branch”: “DB PFK (Deutsche Bank PGK)”,
“street”: “HEAD OFFICE THEODOR-HEUSS-ALLEE 72”,
“city”: “FRANKFURT AM MAIN”,
“postZip”: “60486”,
“region”: “HESSE”,
“country”: “GERMANY”,
“codeDetails”: {
“codeName1”: “BIC”,
“codeValue1”: “DEUTDEDBXXX”,
“codeName2”: “CHIPS”,
“codeValue2”: “”,
“codeName3”: “BIC-4”,
“codeValue3”: “DEUT”,
“codeName4”: “Bankleitzahl BLZ”,
“codeValue4”: “38070724”
},
“additionalData”: {
“ssiAvailable”: “Y”,
“payServiceAvailable”: “Y”,
“contactsAvailable”: “Y”,
“messageAvailable”: “N”,
“holidayAvailable”: “Y”
}
},
“paymentBicDetails”: {
“branchTypeLabel”: “IBAN BIC Branch”,
“bankName”: “DB PRIVAT-UND FIRMENKUNDENBANK AG (FORMERLY DEUTSCHE BANK PGK AG)”,
“branch”: “DB PFK (Deutsche Bank PGK)”,
“street”: “”,
“city”: “BERLIN”,
“postZip”: “”,
“region”: “BERLIN”,
“country”: “GERMANY”,
“codeDetails”: {
“codeName1”: “BIC”,
“codeValue1”: “DEUTDEDB110”,
“codeName2”: “CHIPS”,
“codeValue2”: “”,
“codeName3”: “BIC-4”,
“codeValue3”: “DEUT”,
“codeName4”: “Bankleitzahl BLZ”,
“codeValue4”: “10070848”
},
“additionalData”: {
“ssiAvailable”: “Y”,
“payServiceAvailable”: “Y”,
“contactsAvailable”: “Y”,
“messageAvailable”: “N”,
“holidayAvailable”: “Y”
}
},
“bic8”: “N”,
“dataStore”: “N”,
“noBranch”: “N”,
“isoAddr”: “N”,
“payBranchType”: “D”,
“freeToken”: “XVZQGKsipgIcNHLftxyhpDxKLNxoY4UMcJ1C1CqvCRo6vUw7fBYciiwAieie”
}