# IBAN Structure & ISO Country Codes Scraper (`parseforge/iban-com-bank-codes-scraper`) Actor Retrieve global bank codes from IBAN.com including SWIFT/BIC, country, bank name, branch, city, address, and IBAN format. Validate international payment routing across 100+ countries. Export to JSON, CSV, or Excel for fintech, payments, KYC, and cross border banking compliance workflows. - **URL**: https://apify.com/parseforge/iban-com-bank-codes-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Business, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $12.00 / 1,000 result items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿฆ IBAN Bank Codes & ISO Country Codes Scraper > ๐Ÿš€ **Export validated IBAN structures, SEPA membership, and ISO 3166 country codes in seconds.** Pull per-country IBAN length, example, validation flags, alpha-2, alpha-3, and numeric codes for **250+ territories** in one run. No API key, no registration. > ๐Ÿ•’ **Last updated:** 2026-05-23 ยท **๐Ÿ“Š 11 fields** per record ยท **๐Ÿฆ 250+ countries** ยท **๐Ÿ’ณ SEPA + IBAN structure** ยท **๐Ÿ” 3 modes** The **IBAN Bank Codes Scraper** queries the public IBAN.com reference, the canonical online directory for IBAN format rules and SEPA membership status. It returns **up to 11 structured fields per record**, including country name, alpha-2 code, alpha-3 code, numeric code, SEPA membership flag, IBAN length, IBAN example, account-check flag, branch-check flag, mode used, and the scrape timestamp. The underlying directory is widely cited by payment processors, AML/KYC vendors, and accounting software. The catalog spans **all IBAN-issuing countries, SEPA member states and partial members, plus the full ISO 3166-1 country list (250+ territories)**. This Actor returns IBAN structure, SEPA-only members, or ISO country codes in one run, downloadable as CSV, Excel, JSON, or XML. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Fintech engineers, payment platforms, AML/KYC vendors, accounting and ERP teams, treasury, international remittance, compliance officers | IBAN format validation, SEPA-route detection, KYC country lookups, ISO code reference tables, payment-system onboarding, regulatory reporting | --- ### ๐Ÿ“‹ What the IBAN Bank Codes Scraper does Three lookup workflows in a single run: - ๐Ÿฆ **IBAN structure mode.** Per-country IBAN length, example IBAN, SEPA flag, and validation rules (account-check, branch-check). - ๐Ÿ’ณ **SEPA-only mode.** Partial-member countries that are inside SEPA but do not issue IBANs in the standard structure table. - ๐ŸŒ **ISO 3166-1 country codes mode.** Full country list with alpha-2, alpha-3, and numeric codes. - ๐ŸŽฏ **Country filter.** Optional alpha-2 list to restrict the output to a subset. Each record bundles the country name, country codes, SEPA flag, IBAN length and example, validation flags, the mode used, and the scrape timestamp. > ๐Ÿ’ก **Why it matters:** wrong IBAN structure rules cause rejected payments, failed reconciliation, and regulatory headaches. Maintaining your own table means tracking SEPA membership changes, partial members, and the four annual IBAN registry revisions. This Actor refreshes on every run. --- ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._ --- ### โš™๏ธ Input
InputTypeDefaultBehavior
maxItemsinteger10Records to return. Free plan caps at 10, paid plan at 1,000,000.
modestring"ibanStructure"One of ibanStructure, sepa, countryCodes.
countriesarray[]Optional ISO 3166-1 alpha-2 filter (e.g. ["DE", "FR", "GB"]). Empty returns all.
**Example: full IBAN structure table for all countries.** ```json { "maxItems": 100, "mode": "ibanStructure" } ```` **Example: just SEPA partial-member countries.** ```json { "maxItems": 50, "mode": "sepa" } ``` **Example: ISO country codes filtered to G7.** ```json { "maxItems": 10, "mode": "countryCodes", "countries": ["US", "GB", "DE", "FR", "IT", "CA", "JP"] } ``` > โš ๏ธ **Good to Know:** the IBAN structure table covers 80+ IBAN-issuing countries. The country codes mode covers the full ISO 3166-1 list (250+ entries). Use the country filter when you only need a subset for your payment corridor. *** ### ๐Ÿ“Š Output Each record contains **up to 11 fields** depending on the mode. Download the dataset as CSV, Excel, JSON, or XML. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿณ๏ธ `countryName` | string | `"Germany"` | | ๐Ÿ†” `countryCode` | string | `"DE"` | | ๐Ÿ…ฐ๏ธ `alpha3Code` | string | `"DEU"` | | ๐Ÿ”ข `numericCode` | string | `"276"` | | ๐Ÿ’ณ `sepaMember` | boolean | `true` | | ๐Ÿ“ `ibanLength` | number | null | `22` | | ๐Ÿงพ `ibanExample` | string | null | `"DE89370400440532013000"` | | โœ… `accountCheck` | boolean | `true` | | ๐Ÿ›๏ธ `branchCheck` | boolean | `false` | | ๐Ÿ”ง `mode` | string | `"ibanStructure"` | | ๐Ÿ•’ `scrapedAt` | ISO 8601 | `"2026-05-23T10:00:00.000Z"` | #### ๐Ÿ“ฆ Sample records
๐Ÿฆ IBAN structure: Germany (DE) ```json { "countryName": "Germany", "countryCode": "DE", "sepaMember": true, "ibanLength": 22, "ibanExample": "DE89370400440532013000", "accountCheck": true, "branchCheck": false, "mode": "ibanStructure", "scrapedAt": "2026-05-23T10:00:00.000Z" } ```
๐ŸŒ ISO country code: United States ```json { "countryName": "United States of America (the)", "countryCode": "US", "alpha3Code": "USA", "numericCode": "840", "mode": "countryCodes", "scrapedAt": "2026-05-23T10:00:00.000Z" } ```
๐Ÿ’ณ SEPA-only record ```json { "countryName": "United Kingdom", "countryCode": "GB", "sepaMember": true, "ibanLength": 22, "ibanExample": "GB29NWBK60161331926819", "mode": "sepa", "scrapedAt": "2026-05-23T10:00:00.000Z" } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐Ÿฆ | **Canonical reference.** Pulled from the most widely cited IBAN registry mirror online. | | ๐Ÿ” | **Three modes in one Actor.** IBAN structure, SEPA-only, and ISO country codes from one input form. | | ๐ŸŒ | **250+ countries.** Full ISO 3166-1 list, plus 80+ IBAN-issuing countries with validation rules. | | ๐Ÿ’ณ | **SEPA membership baked in.** Boolean flag per country, including partial members. | | ๐ŸŽฏ | **Country filter.** Pass an alpha-2 list to scope to a specific payment corridor. | | ๐Ÿ” | **Always fresh.** Each run pulls the live page, so SEPA membership and IBAN length changes flow through automatically. | | ๐Ÿšซ | **No authentication.** Works against the public IBAN.com pages. No login or API key needed. | > ๐Ÿ“Š Reliable IBAN rules are the foundation for cross-border payments, AML screening, and reconciliation pipelines. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Setup | |---|---|---|---|---| | **โญ IBAN Bank Codes Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **80+ IBAN, 250+ ISO** | **Live per run** | โšก 2 min | | Hand-written IBAN registry parser | Free + engineering | Same | Build it yourself | ๐Ÿ› ๏ธ Hours | | Commercial validation services | $100+/month | More features | Real-time | โณ Days | | Hard-coded snapshot in code | Free | One snapshot | Manual | ๐Ÿข Tech debt | Pick this Actor when you want canonical IBAN rules and ISO codes with zero parser maintenance and zero per-call billing. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the IBAN Bank Codes Scraper page on the Apify Store. 3. ๐ŸŽฏ **Set input.** Pick a mode and an optional country filter. Set `maxItems`. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor collect your data. 5. ๐Ÿ“ฅ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿฆ Fintech & Payments - IBAN format validation per country - SEPA-route detection in payment routers - Cross-border remittance pricing - Onboarding flow with localized account input #### ๐Ÿ›ก๏ธ AML / KYC & Compliance - Country-risk scoring tables - Sanctions-list joins on alpha-2 / alpha-3 - Account-format checks before submission - Regulatory reporting with ISO numeric codes
#### ๐Ÿ“Š Accounting & ERP - Vendor master record validation - Multi-country bank account onboarding - Reconciliation rule sets per country - Audit-ready IBAN format snapshots #### ๐ŸŒ SaaS & B2B - International billing form validation - Country-picker dropdowns with ISO codes - API request schemas with strict alpha-2 enums - Localized invoice and receipt rendering
*** ### ๐Ÿ”Œ Automating IBAN Bank Codes Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - ๐ŸŸข **Node.js.** Install the `apify-client` NPM package. - ๐Ÿ **Python.** Use the `apify-client` PyPI package. - ๐Ÿ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. A monthly refresh keeps your country and SEPA tables in sync with registry updates. *** ### ๐ŸŒŸ Beyond business use cases IBAN and ISO country codes are foundational reference data. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Cross-border payment friction studies - Open finance datasets for coursework - Regulatory harmonization research - Reproducible country-code crosswalks #### ๐ŸŽจ Personal and creative - Travel apps with local payment hints - Personal budgeting tools - Country quiz games and visualizations - IBAN-format input validators for hobby projects
#### ๐Ÿค Non-profit and civic - International donation form validation - NGO cross-border transfer routing - Civic transparency on payment systems - Refugee and remittance program tooling #### ๐Ÿงช Experimentation - Train AML/KYC models on country tables - Prototype payment-format auto-detectors - Build IBAN parser libraries - Test multi-country e-commerce checkouts
*** ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20IBAN%20Bank%20Codes%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20IBAN%20Bank%20Codes%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20IBAN%20Bank%20Codes%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20IBAN%20Bank%20Codes%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? Pick a mode (`ibanStructure`, `sepa`, or `countryCodes`), optionally pass a country filter, click Start, and the Actor reads the public IBAN.com reference and emits one clean structured record per country. #### ๐Ÿ“ How accurate is the data? The source mirrors the official ISO IBAN registry and ISO 3166-1 country list. SEPA membership reflects the European Payments Council member roster. For mission-critical payment authorization, cross-check with the ISO Registration Authority. #### ๐Ÿ” How often is the dataset refreshed? The IBAN registry is revised quarterly. SEPA membership changes are rare. Every run of this Actor pulls the live page, so any change flows through automatically. #### ๐ŸŒ How many countries are covered? Around 80 IBAN-issuing countries in the structure table, plus the full ISO 3166-1 country list (more than 250 territories) in the country-codes mode. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to run this Actor on any cron interval. A monthly cron keeps your country and SEPA reference tables fresh. #### โš–๏ธ Is this data legal to use? ISO 3166 country codes and IBAN structure rules are open standards. Commercial use is permitted; check the source pages for any attribution preferences. #### ๐Ÿ’ผ Can I use this data commercially? Yes. ISO country codes are public, and IBAN format rules are published as open standards. You are responsible for any downstream compliance with payment regulations specific to your industry. #### ๐Ÿ’ณ Do I need a paid Apify plan to use this Actor? No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and unlocks scheduling, higher concurrency, and full-catalog pulls. #### ๐ŸŒ Does it cover non-IBAN countries (US, Canada, Australia)? Yes for ISO country codes (all 250+ territories). The IBAN structure table only includes countries that officially issue IBANs, so the US, Canada, and Australia appear only in the country-codes mode. #### ๐Ÿ†˜ What if I need help? Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below. *** ### ๐Ÿ”Œ Integrate with any app IBAN Bank Codes Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe IBAN reference data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to refresh downstream payment-validation tables on every run. *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿ’ฑ Frankfurter FX Rates Scraper**](https://apify.com/parseforge/frankfurter-fx-rates-scraper) - ECB-derived foreign-exchange rates - [**๐Ÿ‡ฌ๐Ÿ‡ง GOV.UK Bank Holidays Scraper**](https://apify.com/parseforge/gov-uk-bank-holidays-scraper) - Official UK bank-holiday calendar - [**๐Ÿ›ฌ OurAirports Global Airport Database Scraper**](https://apify.com/parseforge/ourairports-scraper) - Global aviation reference dataset - [**๐ŸŒ Nominatim OSM Scraper**](https://apify.com/parseforge/nominatim-osm-scraper) - Geocode addresses via OpenStreetMap - [**๐Ÿ“ˆ Indexmundi Scraper**](https://apify.com/parseforge/indexmundi-scraper) - Global demographic and economic indicators > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by IBAN.com, the European Payments Council, or the ISO Registration Authority. All trademarks mentioned are the property of their respective owners. Only publicly available open reference data is collected. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `mode` (type: `string`): Which reference set to export: IBAN structure (validated SEPA + non-SEPA), SEPA-only (non-IBAN partial members), or ISO 3166-1 country codes. ## `countries` (type: `array`): Optional ISO 3166-1 alpha-2 codes (e.g. DE, FR, GB). When set, results are filtered to these countries only. Empty = return all. ## Actor input object example ```json { "maxItems": 10, "mode": "ibanStructure" } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "mode": "ibanStructure" }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/iban-com-bank-codes-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10, "mode": "ibanStructure", } # Run the Actor and wait for it to finish run = client.actor("parseforge/iban-com-bank-codes-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "mode": "ibanStructure" }' | apify call parseforge/iban-com-bank-codes-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/iban-com-bank-codes-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "IBAN Structure & ISO Country Codes Scraper", "description": "Retrieve global bank codes from IBAN.com including SWIFT/BIC, country, bank name, branch, city, address, and IBAN format. Validate international payment routing across 100+ countries. Export to JSON, CSV, or Excel for fintech, payments, KYC, and cross border banking compliance workflows.", "version": "1.0", "x-build-id": "y5IidBNTnc4Oa1dlk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~iban-com-bank-codes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-iban-com-bank-codes-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~iban-com-bank-codes-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-iban-com-bank-codes-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~iban-com-bank-codes-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-iban-com-bank-codes-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "mode": { "title": "Mode", "enum": [ "ibanStructure", "sepa", "countryCodes" ], "type": "string", "description": "Which reference set to export: IBAN structure (validated SEPA + non-SEPA), SEPA-only (non-IBAN partial members), or ISO 3166-1 country codes." }, "countries": { "title": "Countries (alpha-2 filter)", "type": "array", "description": "Optional ISO 3166-1 alpha-2 codes (e.g. DE, FR, GB). When set, results are filtered to these countries only. Empty = return all.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```