Catalog/ref-iban-bank-resolve

Reference

Resolve an IBAN to its real bank name / BIC / branch (live) API

Resolves an IBAN to the actual issuing bank via openiban.com's LIVE bank directory: bank name, BIC, national bank code, and city, plus a structural decode (country, check digits) and bank-code validity. Answers 'which bank issued this IBAN', 'what BIC corresponds to this account', 'is this IBAN's bank code valid'. Distinct from our offline IBAN/BIC validators, which only check structure and resolve a small curated set of well-known banks.

Price$0.01per request
MethodPOST
Route/v1/ref/iban-bank-resolve
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache86400s public
refibanbankbicswiftpaymentskybbank-directoryregistry
API URLhttps://x402.hexl.dev/v1/ref/iban-bank-resolve
Integration docs
Example request
{
  "iban": "DE89370400440532013000"
}
Example response
{
  "iban": "DE89370400440532013000",
  "valid": true,
  "country": "DE",
  "checkDigits": "89",
  "bankResolved": true,
  "bank": {
    "name": "Commerzbank",
    "bic": "COBADEFFXXX",
    "bankCode": "37040044",
    "city": "Köln",
    "zip": "50447"
  },
  "bankCodeValid": true,
  "messages": [
    "Bank code valid: 37040044"
  ],
  "note": null
}
Input schema
{
  "type": "object",
  "required": [
    "iban"
  ],
  "properties": {
    "iban": {
      "type": "string",
      "description": "IBAN string (spaces allowed); resolution available for countries with a public bank directory (DE, NL, CH, AT, LU, BE, BG)."
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}