Developer tools
OpenIBAN IBAN Validator — Bulk IBAN Checker
Bulk IBAN validation against the free, keyless openiban.com REST API — one row back per IBAN, with checksum validity, bank-code/BIC enrichment where available, and a clear per-row diagnostic, so a payments or KYC team can run an IBAN validator job against a whole customer list in one go.
Free Apify credit covers a first run. No credit card to try.
What this Actor scrapes
A customer hands us a list of IBANs — mixed formatting, mixed countries — and we return one row per IBAN: checksum validity, bank-code validation result, bank name/BIC where the free openiban.com directory has it, and the raw messages[] explaining which of two failure modes hit (bad checksum vs. unresolved bank code). Built for a recurring fintech/payments/AP-AR/KYC batch job against a whole customer list, not a one-off lookup: one bad IBAN never fails a 5,000-row batch.
What we handle for you
- 🧾 Any common IBAN format, one clean value — glued (
DE89370400440532013000) or spaced (DE89 3704 0044 0532 0130 00) both normalize before we ever call openiban. - 🧱 Bounded, polite concurrency — openiban is a free, shared keyless service, so we cap in-flight requests and back off automatically on
429/5xxinstead of hammering it. - ✅ Clean negatives are not errors — an invalid IBAN is a normal, useful answer. Every entry — valid, cleanly invalid, or unparseable — lands as its own row with a clear status, so one bad IBAN never fails your whole batch.
- 🔍 Two failure modes, disambiguated —
messages[]passes through verbatim so you can tell a bad checksum apart from an unresolved bank code, instead of a single flattened boolean. - 🧊 Typed, validated dataset rows — Pydantic-checked, one row per requested IBAN, every time — the row count you get back always matches the row count you sent in.
- 💰 Pay-Per-Event pricing — priced for volume, not per-lookup margin. You always know what a batch costs before you run it.
Use cases
- Payment/AP-AR teams — validate a beneficiary's IBAN before a wire transfer to avoid a bounced payment.
- Compliance/KYC onboarding — batch-check IBANs on file as part of a customer onboarding sweep.
- ERP/accounting pipeline enrichment — attach bank name and BIC to existing vendor or customer records.
- Data-quality cleanup — find and flag malformed IBANs sitting in a spreadsheet or CRM export.
Input
Paste this into the Apify Console, or send it as the run input over the API. Proxy settings are on by default; you rarely need to touch them.
| Field | Type | Required | What it does |
|---|---|---|---|
ibans | array | yes | IBANs to validate, one per list item. Whitespace is stripped before use, so "DE89 3704 0044 0532 0130 00" is accepted alongside glued strings. |
maxConcurrency | integer | no | Cap on concurrent requests to openiban.com. Kept low by design — a free, shared keyless service. |
{
"ibans": [
"DE89 3704 0044 0532 0130 00",
"DE89370400440532013001",
"NL91ABNA0417164300"
],
"maxConcurrency": 3,
"proxyConfiguration": {
"useApifyProxy": true
}
} Output
One row per result, schema-validated before it is written. Export JSON, CSV, Excel or XML from the run, or read it over the API.
ibanvalidbankCodebankNamebicbankCitybankZipbankCodeValidmessagesskippedskipReason
{
"iban": "DE89370400440532013000",
"valid": true,
"bankCode": "37040044",
"bankName": "Commerzbank",
"bic": "COBADEFFXXX",
"bankCity": "K\u00f6ln",
"bankZip": "50447",
"bankCodeValid": true,
"messages": [
"Bank code valid: 37040044"
],
"skipped": false,
"skipReason": null
} Pricing
| Event | Price | When |
|---|---|---|
| Actor start | $0.20 | Once per run, covers warm-up and proxy session setup. |
| IBAN checked | $0.0010 | Per result written to the dataset. |
You pay only for results that land. Cap any run with maxTotalChargeUsd. See pricing & billing for worked examples.
Limitations
- Bank-directory enrichment (bank name, BIC, city, ZIP) is confirmed for DE and NL only. AT, CH, and BE are unconfirmed — we neither claim support nor absence. FR, GB, ES, IT, and PL are confirmed checksum-only (no bank-directory match).
- Checksum validation itself works across all IBAN-format countries — the enrichment gap above only affects the bank-directory fields.
- Concurrency is capped at 5 requests in flight by design — openiban.com is a free, shared keyless service.
- No caching or dedup of previously-seen IBANs across runs — every run re-checks every IBAN you send.
- openiban.com is a free, single-maintainer service — its uptime and rate-limit posture aren't contractually guaranteed.
FAQ
Why is `valid` sometimes `false` even though the IBAN's checksum is fine?
valid reflects both checksum AND bank-code/BIC validation. An IBAN can have a perfect checksum but still come back valid: false if its bank code doesn't resolve — check messages[] on that row to see exactly which check failed.Is an invalid IBAN a failed run?
valid: false with an explanation in messages[].What happens if one IBAN in my batch is malformed?
valid: false and a messages[] entry explaining why — the rest of your batch is processed normally. Only a genuinely empty entry, or a request that fails after retries, is marked skipped: true.Does this actor call a paid IBAN-validation service?
Ready to run it?
Open the listing on Apify, paste the input above, and watch rows land. If it ever breaks, it is our problem before it is yours.
Related Actors