SWIFT/BIC validate & resolve API

Validate the ISO 9362 BIC structure (the 8-vs-11, test-flag and primary-office rules LLMs get subtly wrong) and decode every component — institution/bank code, ISO-3166 country (mapped to a country name), location code, branch — flagging test BICs and passive participants, and resolving a curated snapshot of well-known institutions to a bank name. Deterministic, offline. Answers 'is this a valid SWIFT/BIC code', 'what bank is this BIC', 'decode this BIC', 'what country is this SWIFT code'.

Price$0.01per request

MethodPOST

Route/v1/identity/swift-bic

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

identityswiftbiciso-9362bank-codevalidationbankingswift-code

API URLhttps://x402.hexl.dev/v1/identity/swift-bic

Integration docs

Example request

{
  "bic": "DEUTDEFF500"
}

Example response

{
  "bic": "DEUTDEFF500",
  "valid": true,
  "bankCode": "DEUT",
  "countryCode": "DE",
  "country": "Germany",
  "locationCode": "FF",
  "branchCode": "500",
  "branch": "500",
  "length": 11,
  "isPrimaryOffice": false,
  "isTestBic": false,
  "isPassive": false,
  "bankName": "Deutsche Bank AG"
}

Input schema

{
  "type": "object",
  "required": [
    "bic"
  ],
  "properties": {
    "bic": {
      "type": "string",
      "examples": [
        "DEUTDEFF500",
        "CHASUS33"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}