IBAN Structure & Country Codes Scraper

IBAN Structure & Country Codes Scraper

Scrape IBAN structure, SEPA membership, and ISO 3166-1 country codes from IBAN.com. Every record includes the country code, IBAN length, BBAN format, and validation rules. Export to JSON, CSV, Excel, or XML.

IBAN.com publishes the official IBAN registry, SEPA country lists, and ISO 3166-1 codes, but the data is spread across pages and not available as a single download. This Actor reads those public reference tables directly and returns one flat row per country or bank code, filtered by country if you need a subset.

Who uses it	What they scrape IBAN.com for
Fintech developers	Validate IBANs in their payment forms without hardcoding country rules
Compliance officers	Confirm which countries are SEPA members for cross-border payment routing
Data analysts	Build a reference table of country codes and IBAN formats for internal tools
ERP integrators	Populate bank account validation rules in enterprise resource planning systems

What it does

This Actor collects IBAN structure details, SEPA-only membership, or ISO 3166-1 country codes from IBAN.com and returns each entry as a flat row.

• 🌍 Three reference sets: IBAN structure per country, SEPA-only partial members, or ISO 3166-1 country codes.
• 🔍 Country filter: Pass ISO alpha-2 codes like DE or FR to return only those countries.
• 📦 Flat output: Each row contains the country code, IBAN length, BBAN format, and validation details.
• ⚙️ Flexible limits: Set maxItems from 1 to 1,000,000 to control the size of each run.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with IBAN.com data

💳 Validate IBANs in a payment form.

A fintech developer runs the Actor in IBAN Structure mode, filters to the countries their app supports, and uses the returned lengths and BBAN patterns to validate user input before sending a payment.

🌐 Build a SEPA country checklist.

A compliance officer runs the Actor in SEPA-only mode to get the current list of partial members, then cross-checks it against their routing tables to avoid rejected transfers.

🗂️ Refresh a country code reference table.

A data analyst runs the Actor in ISO 3166-1 mode on a schedule, exports the rows to CSV, and loads them into their data warehouse to keep country dimensions accurate.

🔧 Configure ERP bank validation.

An ERP integrator runs the Actor once per quarter, filters to the countries where the company operates, and imports the IBAN structure into the system's bank account validation module.

Why choose this scraper

	What you get
Official source	Data comes directly from IBAN.com, the registry used by banks and payment processors.
No API key	The Actor reads the public reference pages, so you do not need to register or authenticate.
Structured output	Every row follows the same schema, ready for import into a database or spreadsheet.
Up to date	Each run fetches the current tables, so your validation rules stay current.

How it compares

No other Store actor targets IBAN.com the same way, so the honest comparison is with the alternatives teams actually weigh.

	IBAN Structure & Country Codes Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When IBAN.com changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor with a mode selector and an optional list of ISO alpha-2 country codes. The country filter is applied as the data is read, so only matching rows reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
 "maxItems": 10,
 "mode": "ibanStructure"
}

A larger pull:

{
 "maxItems": 200,
 "mode": "ibanStructure"
}

Pricing

Pay-per-result: $0.016 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$1.60
1,000 results	$16.00
10,000 results	$160.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the IBAN Structure & Country Codes Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to IBAN.com through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/iban-com-bank-codes-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check the countries filter. If you passed an array of alpha-2 codes, make sure they are valid ISO codes and that the selected mode contains those countries. For example, SEPA-only mode will not return non-SEPA countries.

The run stops before returning all countries.

Increase the maxItems value. The default is 10, which is a small sample. Set it to a higher number, up to 1,000,000, to get the full list.

Some fields are empty in the output.

Not all fields apply to every mode. For example, IBAN-specific fields are empty in ISO 3166-1 mode. Check the mode you selected and the expected schema.

The Actor fails with a timeout.

IBAN.com may be slow to respond. Try running the Actor again, or reduce the maxItems to a smaller number and run multiple batches.

FAQ

Question	Answer
What is the difference between the three modes?	IBAN Structure returns the full IBAN registry for all countries, including non-SEPA. SEPA-only returns countries that are partial SEPA members and use IBAN but are not full members. ISO 3166-1 returns the standard country code list.
Can I filter by country?	Yes. Pass an array of ISO 3166-1 alpha-2 codes in the countries field, for example DE, FR, GB. Leave it empty to return all countries.
Does this Actor require an API key or login?	No. It reads the public reference tables on IBAN.com, so no authentication is needed.
How many records can I get in one run?	You can set maxItems from 1 to 1,000,000. The default is 10, which is useful for testing. For a full export, set a higher limit.
What fields are included in the output?	Each row includes the country code, country name, IBAN length, BBAN format, and validation details such as character sets and check digit positions. The exact fields depend on the mode.
Can I schedule this Actor to run automatically?	Yes. Use Apify's scheduler to run it daily, weekly, or monthly, and store the results in a dataset or send them to a webhook.
Is the data from IBAN.com reliable?	IBAN.com is the official registry for IBAN structures and is used by banks and payment processors worldwide. The Actor extracts the data exactly as published.
Can I export the results to Excel or CSV?	Yes. After the run, you can download the dataset as JSON, CSV, Excel, or XML from the Apify platform.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by IBAN.com. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.