IBAN Validator

Validate IBAN numbers and extract the bank code and account number. Supports all countries in the official SWIFT IBAN Registry. Returns a structured response for both valid and invalid IBANs — the valid field tells you whether the IBAN passed checksum validation.

Get API Key

Vue d'ensemble

Cas d'utilisation

  • Payment form validation before submission
  • Fintech apps processing international bank transfers
  • Fraud detection pipelines verifying account details
  • Accounting software importing supplier bank details
  • KYC / AML workflows verifying customer bank accounts

Fonctionnalités

ISO 13616 checksum validation (mod-97 algorithm)
Country-specific length validation for ~80 countries
Bank code extraction (Bankleitzahl, sort code, etc.)
Account number extraction from the BBAN
Accepts IBANs with or without spaces
Case-insensitive input
Always returns 200 — the valid field signals pass/fail

Points de terminaison de l'API

Validate IBAN

Validates an IBAN and returns the country, bank code, and account number. Spaces in the input are stripped automatically. Always returns HTTP 200 — check the valid field to determine whether the IBAN is valid.

GET
https://requiems.xyz/v1/finance/iban/{iban}

Paramètres

Nom Type Requis Description
iban string Requis The IBAN to validate. Spaces are stripped. Case-insensitive.

Essayez-le

Démo en direct
Requête

The IBAN to validate. Spaces are stripped. Case-insensitive.

Champs de réponse

Champ Type Description
iban string The normalised IBAN (spaces stripped, uppercased)
valid boolean true if the IBAN passed length and ISO 13616 checksum validation
country string Full country name (empty if the country code is not in the registry)
bank_code string Bank identifier extracted from the BBAN (empty if country not in registry or positions not defined)
account string Account number extracted from the BBAN (empty if country not in registry or positions not defined)

Exemples de code

curl "https://requiems.xyz/v1/finance/iban/DE89370400440532013000" \
  -H "requiems-api-key: YOUR_API_KEY"

# With spaces (URL-encoded):
curl "https://requiems.xyz/v1/finance/iban/DE89%203704%200044%200532%200130%2000" \
  -H "requiems-api-key: YOUR_API_KEY"

Réponses d'erreur

internal_error

Unexpected server error (e.g. database unreachable).

Batch Validate IBANs

Validates up to 50 iban numbers in a single request. Results are returned in the same order as the input.

POST
https://requiems.xyz/v1/finance/iban/batch

Paramètres

Nom Type Requis Description
numbers array<string> Requis Array of iban numbers to validate (min: 1, max: 50).

Essayez-le

Démo en direct
Requête

Array of iban numbers to validate (min: 1, max: 50).

Champs de réponse

Champ Type Description
results array<object> Validation result for each number in the same order as the input. Each item has the same fields as the single validate endpoint.
total integer Number of results returned. Matches the length of the input array.

Exemples de code

curl -X POST "https://requiems.xyz/v1/finance/iban/batch" \
  -H "requiems-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers":["GB29NWBK60161331926819","DE89370400440532013000"]}'

Réponses d'erreur

validation_failed

The numbers array is missing, empty, or contains more than 50 items.

Foire aux questions