Skip to content
Last updated

The IBAN (International Bank Account Number) endpoints in the Bank Match API allow you to verify and match company bank account details using the IBAN format. These endpoints support compliance, fraud prevention, and onboarding processes for companies in a wide range of supported countries.

Below is a flow diagram guide on how to use these endpoints effectively.

Flow Diagram

Authenticate
Retrieve IBAN Search Criteria
Run IBAN Company Search
Review Search Results

Supported Countries for IBAN

Country NameCountry Code
AlbaniaAL
AndorraAD
AustriaAT
AzerbaijanAZ
BahrainBH
BelarusBY
BelgiumBE
Bosnia and HerzegovinaBA
BrazilBR
British Virgin IslandsVG
BulgariaBG
Costa RicaCR
CroatiaHR
CyprusCY
Czech RepublicCZ
DenmarkDK
Dominican RepublicDO
EgyptEG
El SalvadorSV
EstoniaEE
Faroe IslandsFO
FinlandFI
FranceFR
GeorgiaGE
GermanyDE
GibraltarGI
GreeceGR
GreenlandGL
GuatemalaGT
HungaryHU
IcelandIS
IraqIQ
IrelandIE
IsraelIL
ItalyIT
JordanJO
KazakhstanKZ
KosovoXK
KuwaitKW
LatviaLV
LebanonLB
LiechtensteinLI
LithuaniaLT
LuxembourgLU
North MacedoniaMK
MaltaMT
MauritaniaMR
MauritiusMU
MoldovaMD
MonacoMC
MontenegroME
New CaledoniaNC
NetherlandsNL
NorwayNO
PakistanPK
PalestinePS
PolandPL
PortugalPT
QatarQA
RomaniaRO
Saint LuciaLC
San MarinoSM
Sao Tome and PrincipeST
Saudi ArabiaSA
SerbiaRS
SeychellesSC
SlovakiaSK
SloveniaSI
SpainES
SwedenSE
SwitzerlandCH
Timor-LesteTL
TunisiaTN
TurkeyTR
UkraineUA
United Arab EmiratesAE
United KingdomGB

1. Authenticate

Before using any of the endpoints, you must authenticate. This ensures you have the necessary permissions to access the data.

View endpoint documentation

Example Request

POST /authenticate

2. Retrieve IBAN Search Criteria

This endpoint returns the supported languages and required criteria for IBAN company searches.

View endpoint documentation

Example Request

GET /compliance/bankMatch/IBAN/company/searchCriteria?bankCountry=DE

Example Response

{
    "correlationId": "e7334c77-f9eb-49f5-9212-b6c637e91862",
    "criteriaSets": [
        {
            "regNo": {
                "required": true
            },
            "country": {
                "required": true
            },
            "iban": {
                "validationRegExp": "^DE\\d{20}$",
                "required": true
            }
        }
    ],
    "bankCountry": "DE",
    "languages": [
        "EN",
        "FR",
        "ES",
        "IT"
    ]
}

Use this endpoint to search and match company bank account details using the IBAN format.

View endpoint documentation

Example Request

POST /compliance/bankMatch/IBAN/company

4. Review Search Results

After submitting an IBAN company search, review the response to determine if the bank account details have been successfully matched.