apyhub
Back
▣ DATA VALIDATION · FINANCE

Validate IBAN Checksum API

What it does

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.

GET
Validate IBAN
https://api.eu.apyhub.com/dosvak/validate-iban-checksum

QUICKSTART

GUIDE

Quickstart

Check whether an IBAN is valid by sending it as a query parameter.

curl -X GET "https://api.eu.apyhub.com/dosvak/validate-iban-checksum?iban=GB82WEST12345698765432" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

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": []
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

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.

Query Parameter(s)

AttributeTypeMandatoryDescription
ibanStringYesIBAN to validate. Minimum length: 5 characters; maximum length: 40 characters.

Response

Returns a JSON object with the normalized IBAN, the country's expected length against the length supplied, the checksum result, and the overall verdict.

ParameterTypeMandatoryDescription
inputStringYesThe IBAN supplied in the request.
normalizedStringYesThe IBAN with whitespace removed and letters upper-cased.
country_codeStringYesTwo-letter ISO country code taken from the first two characters.
expected_lengthIntegerYesIBAN length the country's format requires.
actual_lengthIntegerYesLength of the normalized IBAN.
checksum_validBooleanYestrue when the IBAN passes the ISO 7064 mod-97 checksum.
validBooleanYesOverall verdict. true when the length matches and the checksum passes.
reasonStringYesWhy the verdict was reached, for example ok.
attributionObject ArrayNoSource attribution entries. Empty when no attribution is required.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLValidate IBAN APIApyHubCALLAdvanced IBAN Validation APIQuadlem, LLCCALLValidate Payment Card APInick creightonCALLIdentity & Fraud Verification APIQuadlem, LLC

From the blog

Reads that touch this API.

IFSC Code Validation API: Verify Indian Bank Details Before You Send MoneyAug 7, 2026Validate IBAN API: IBAN Validation for Developers and Secure PaymentsJul 9, 2026Data Validation APIs: What Your Checks Actually ProveSep 8, 2026Aadhaar Validation API – Secure & Instant Identity Verification for DevelopersJul 9, 2026