# IBAN Company Endpoints

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


```mermaid
%%{ init: { "theme": "default" } }%%
flowchart TB
  A[Authenticate]
  B[Retrieve IBAN Search Criteria]
  C[Run IBAN Company Search]
  D[Review Search Results]

  A --> B --> C --> D
```

## Supported Countries for IBAN

| Country Name | Country Code |
|  --- | --- |
| Albania | AL |
| Andorra | AD |
| Austria | AT |
| Azerbaijan | AZ |
| Bahrain | BH |
| Belarus | BY |
| Belgium | BE |
| Bosnia and Herzegovina | BA |
| Brazil | BR |
| British Virgin Islands | VG |
| Bulgaria | BG |
| Costa Rica | CR |
| Croatia | HR |
| Cyprus | CY |
| Czech Republic | CZ |
| Denmark | DK |
| Dominican Republic | DO |
| Egypt | EG |
| El Salvador | SV |
| Estonia | EE |
| Faroe Islands | FO |
| Finland | FI |
| France | FR |
| Georgia | GE |
| Germany | DE |
| Gibraltar | GI |
| Greece | GR |
| Greenland | GL |
| Guatemala | GT |
| Hungary | HU |
| Iceland | IS |
| Iraq | IQ |
| Ireland | IE |
| Israel | IL |
| Italy | IT |
| Jordan | JO |
| Kazakhstan | KZ |
| Kosovo | XK |
| Kuwait | KW |
| Latvia | LV |
| Lebanon | LB |
| Liechtenstein | LI |
| Lithuania | LT |
| Luxembourg | LU |
| North Macedonia | MK |
| Malta | MT |
| Mauritania | MR |
| Mauritius | MU |
| Moldova | MD |
| Monaco | MC |
| Montenegro | ME |
| New Caledonia | NC |
| Netherlands | NL |
| Norway | NO |
| Pakistan | PK |
| Palestine | PS |
| Poland | PL |
| Portugal | PT |
| Qatar | QA |
| Romania | RO |
| Saint Lucia | LC |
| San Marino | SM |
| Sao Tome and Principe | ST |
| Saudi Arabia | SA |
| Serbia | RS |
| Seychelles | SC |
| Slovakia | SK |
| Slovenia | SI |
| Spain | ES |
| Sweden | SE |
| Switzerland | CH |
| Timor-Leste | TL |
| Tunisia | TN |
| Turkey | TR |
| Ukraine | UA |
| United Arab Emirates | AE |
| United Kingdom | GB |


## 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](https://doc.creditsafe.com/connect-apis-catalog/product-catalog/bankmatch/bankmatch/authentication)

### Example Request


```http
POST /authenticate
```

## 2. Retrieve IBAN Search Criteria

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

[View endpoint documentation](https://doc.creditsafe.com/connect-apis-catalog/product-catalog/bankmatch/bankmatch/bank-match/compliancegetbankmatchibancompanysearchcriteria)

### Example Request


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

### Example Response


```json
{
    "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"
    ]
}
```

## 3. IBAN Company Search

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

[View endpoint documentation](https://doc.creditsafe.com/connect-apis-catalog/product-catalog/bankmatch/bankmatch/bank-match/compliancegetbankmatchibancompanysearch)

### Example Request


```http
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.