IBAN Lookup avatar

IBAN Lookup

Pricing

$8.00 / 1,000 requests

Go to Apify Store
IBAN Lookup

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

Greip

Maintained by Community

Actor stats

0

Bookmarked

8

Total users

0

Monthly active users

5 days ago

Last modified

Features

Limited permissions

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

ParameterTypeRequiredDefaultDescription
ibanstringYesIBAN to validate (e.g. BE71096123456769 or BE71 0961 2345 6769)
modestringNolivelive 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 request
  • isValid: Whether the IBAN is correctly formatted and valid
  • machineFormat: Machine-readable format (no spaces)
  • humanFormat: Human-readable format (with spaces)
  • obfuscatedFormat: Partially masked IBAN for display (BE** **** **** 6769 style from Greip)

Country information:

  • countryName: Country name for the issuing bank
  • countryIANA: IANA country code (country.iana in v2)
  • countryISO3166: ISO 3166 code when provided (country.iso3166, nullable)
  • countryCurrency: Official currency
  • countryMembership: Bank membership type (e.g. eu_member)
  • countryIsEU: EU membership (country.is_eu); null when the API omits the field
  • countryLength: Standard IBAN length for the country as a string (v2 country.length is numeric in JSON but this Actor keeps the 1.x string output, e.g. "16")
  • countryIsSEPA: SEPA participation (country.is_sepa); null when omitted
  • countrySwiftOfficial: SWIFT network flag (country.swift_official); null when omitted
  • countryExampleIban: 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 from country.central_bank

  • bankIdentifier: Bank BIC/SWIFT when available (e.g. GEBABEBB)

  • bankName, bankShortName, bankBranchCode, bankBban: Institution details from data.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.