IBAN Validator checks whether a provided IBAN is formatted and structured correctly.
Send an iban string in the query. The value must be between 5 and 40 characters, and the service validates the IBAN structure, country code, length, and checksum according to the IBAN specification.
Use IBAN Validator when you need to catch bad bank account identifiers before they reach payment flows, onboarding forms, or back-office systems. It is a fit for checkout validation, beneficiary setup, and any workflow where a single invalid IBAN can trigger failed transfers or manual review.
If you are normalising financial data from user input or third-party imports, this endpoint gives you a simple check step to gate downstream processing without building IBAN rules yourself.
Check whether an IBAN is valid by sending it as a query parameter.
curl -X GET "http://localhost:8080/dosvak/validate-iban-checksum?iban=GB82WEST12345698765432" \
-H "apy-token: $APY_TOKEN"Returns a JSON object containing the IBAN validation result, including the normalized IBAN, country code, length validation, checksum validation, overall validity, and attribution information.
{
"input": "GB82WEST12345698765432",
"normalized": "GB82WEST12345698765432",
"country_code": "GB",
"expected_length": 22,
"actual_length": 22,
"checksum_valid": true,
"valid": true,
"reason": "ok",
"attribution": []
}Loading your default key…Validates an IBAN provided as a query parameter and returns a JSON object containing the validation result, including the normalized IBAN, country code, length checks, checksum validation, and overall validity.
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| iban | String | Yes | IBAN to validate. Minimum length: 5 characters; maximum length: 40 characters. |
bad_requestRequired parameter missing or malformed body.
unauthorizedAPI key missing, revoked, or not authorized for this service.
rate_limitedYour plan's per-second rate exceeded. Retry with exponential backoff.
upstream_busyBackend temporarily unavailable. Try again in a few seconds.