API requests

What does an API request look like?

The IBAN-Test API can be called via HTTP requests. Use your API token as described in the API documentation.

Check an IBAN:
https://www.iban-test.eu/api/check/{iban}?authcode={authcode}

Generate an IBAN:
https://www.iban-test.eu/api/generate?authcode={authcode}&bankcode={bankcode}&accountnumber={accountnumber}&countrycode={countrycode}

Get token information:
https://www.iban-test.eu/api/info/{authcode}

For the current endpoints, response fields and examples, please use the API documentation.

To the top

API response

What does the API return?

API responses are returned as JSON. Typical fields include:

error = boolean, whether an error occurred
code = integer, result or status code
message = string, human-readable result message

Depending on the endpoint, the response can also include validation details, generated IBAN data, BIC information, bank information or API token usage details.

For the current response format and examples, see the API documentation.

To the top

API locked or disabled

Why is my API access locked or disabled?

This can happen when the daily request limit has been reached, when a token is invalid, or when suspicious or abusive usage is detected.

If you only reached your daily limit, you can wait for the reset or upgrade to a package with a higher request volume.

If your access appears to be blocked for another reason, please contact support.

To the top

Bank data validation

Validation against bank directories

For these countries, we check IBANs against available bank directories and return bank details such as institution, city and BIC when available.

DEGermany ATAustria BEBelgium FRFrance LULuxembourg NLNetherlands PTPortugal ESSpain

IBAN syntax check

Format checks for 111 IBAN countries

Check IBANs for a valid structure, correct length and checksum. This helps you catch typos and transposed digits before a payment fails. Additional bank validation against real bank directories is available for the countries listed above.