IBAN Lookup
Pricing
$8.00 / 1,000 requests
IBAN Lookup
Validate International Bank Account Numbers (IBANs) and retrieve comprehensive country information, banking details, formatting options, and validation results. Ideal for financial services, compliance checks, and fraud prevention.
Pricing
$8.00 / 1,000 requests
Rating
0.0
(0)
Developer
Greip
Maintained by CommunityActor stats
0
Bookmarked
8
Total users
0
Monthly active users
5 days ago
Last modified
Categories
Features
Share
Greip's IBAN Lookup
A robust Apify Actor that validates International Bank Account Numbers (IBANs) using the Greip IBAN Lookup API (v2). This tool helps verify IBAN formatting and retrieves comprehensive information about the associated country and banking institution, enhancing security and accuracy in financial transactions.
Features
- IBAN Validation: Verify if IBANs are correctly formatted and valid
- Country Information: Get detailed information about the country associated with each IBAN
- Banking Details: Retrieve institution and central bank information
- Multiple Formats: Get IBANs in machine-readable, human-readable, and obfuscated formats
- SEPA and SWIFT Validation: Check for SEPA participation and SWIFT network compatibility
- Structured Output: Clean, well-formatted JSON results stored in datasets
API endpoint
The Actor calls:
GET https://v2.greipapi.com/lookup/iban/{iban}?source=Apify
Optional query parameter mode=test returns deterministic fake data without consuming quota (see input mode).
Authentication uses the GREIP_API_KEY environment variable as a Bearer token. The key is never logged or included in output.
Input Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
iban | string | Yes | IBAN to validate (e.g. BE71096123456769 or BE71 0961 2345 6769) | |
mode | string | No | live | live for real data, test for deterministic fake data (no quota usage) |
Invalid mode values are rejected with a clear input error (only live and test are allowed).
Output Format
The Actor outputs detailed information about each IBAN (example values match the Greip v2 IBAN docs):
{"iban": "BE71096123456769","isValid": true,"machineFormat": "BE71096123456769","humanFormat": "BE71 0961 2345 6769","obfuscatedFormat": "BE** **** **** 6769","countryName": "Belgium","countryIANA": "be","countryISO3166": "BE","countryCurrency": "EUR","countryMembership": "eu_member","countryIsEU": true,"countryLength": "16","countryIsSEPA": true,"countrySwiftOfficial": true,"centralBankName": "National Bank of Belgium","centralBankUrl": "http://www.nbb.be/","bankIdentifier": "GEBABEBB","bankName": "BNP Paribas Fortis","bankShortName": null,"bankBranchCode": null,"bankBban": null,"countryExampleIban": null,"timestamp": "2026-01-14T12:00:00.000Z"}
Output Field Descriptions
IBAN validation fields:
iban: The original IBAN provided in the requestisValid: Whether the IBAN is correctly formatted and validmachineFormat: Machine-readable format (no spaces)humanFormat: Human-readable format (with spaces)obfuscatedFormat: Partially masked IBAN for display (BE** **** **** 6769style from Greip)
Country information:
countryName: Country name for the issuing bankcountryIANA: IANA country code (country.ianain v2)countryISO3166: ISO 3166 code when provided (country.iso3166, nullable)countryCurrency: Official currencycountryMembership: Bank membership type (e.g.eu_member)countryIsEU: EU membership (country.is_eu); null when the API omits the fieldcountryLength: Standard IBAN length for the country as a string (v2country.lengthis numeric in JSON but this Actor keeps the 1.x string output, e.g."16")countryIsSEPA: SEPA participation (country.is_sepa); null when omittedcountrySwiftOfficial: SWIFT network flag (country.swift_official); null when omittedcountryExampleIban: Example IBAN for the country when returned by the API
Boolean fields: Unlike v1, missing boolean fields from Greip are output as JSON null, not defaulted to false.
Bank and central bank:
-
centralBankName,centralBankUrl: Central bank fromcountry.central_bank -
bankIdentifier: Bank BIC/SWIFT when available (e.g.GEBABEBB) -
bankName,bankShortName,bankBranchCode,bankBban: Institution details fromdata.bank -
timestamp: When the validation was performed
Use Cases
This Actor is ideal for:
- Payment Processing: Validate IBANs before processing international transactions
- Financial Services: Ensure IBAN accuracy in banking applications
- Fraud Prevention: Verify the legitimacy of provided banking information
- Compliance: Meet regulatory requirements for financial data validation
- Risk Assessment: Assess country-specific banking risks and regulations
Your feedback
We're always working on improving the performance of our Actors. If you have any technical feedback for IBAN lookup or found a bug, please create an issue in the Issues tab.