Skip to main content
GET
Get bank information for iban

Overview

This endpoint retrieves comprehensive bank information based on an IBAN. Use it to validate account details and check payment scheme support before initiating transactions.

Information Provided

  • Bank Identifier Code (BIC)
  • Bank name
  • Supported SEPA schemes
  • Reachability status

Use Cases

  • IBAN validation
  • Payment routing verification
  • Scheme compatibility checks
  • Bank identification

Unresolvable IBANs

If the bank for the IBAN cannot be resolved (the IBAN is not covered by the bank directory or its format is invalid), the endpoint returns HTTP 400 with an error message such as Failed to resolve bic for iban. Treat this as “unknown bank”: before creating a payment to such an IBAN, either obtain the BIC from the payer and pass it explicitly in the payment request, or reject the payment on your side. The same resolution is used when a payment is created without a BIC, so calling this endpoint first lets you catch the problem before the payment is submitted.

Path Parameters

iban
string
required

Iban to get information for

Response

Returned iban information

bic
string
required

Bank BIC.

Example:

"EXAMPLEBICX"

sepaSchemas
object
required

Map of supported payment schemas.

Example:
address
object | null

Structured bank address. Returned only for SWIFT-reachable banks; may be absent when the reference data has no structured address.

bankName
string | null

Bank name. For SWIFT-reachable banks this is the institution name from SWIFT reference data; otherwise it is resolved from the BIC directory and returned only when enabled by tenant configuration.

Example:

"EXAMPLE BANK LTD"

Last modified on September 2, 2026