v4

latestOpenAPI 3.1.02026-08-0117737.6 KB

Compliance

Full IBAN compliance check

Validates an IBAN and returns everything from /v1/iban/validate PLUS a full compliance layer: sanctions screening (OFAC), FATF status, SEPA Instant reachability, VoP participant check, and a composite risk score (0-100). Costs $0.02 USDC via x402.

post/v1/iban/compliance

Request body

ibanstring required

IBAN to check

Example request

{
  "iban": "DE89370400440532013000"
}

Response

Compliance check result (includes full IBAN validation + compliance layer)

ibanstring required

The IBAN as provided (normalized)

validboolean required

check_digitsstring

formattedstring

IBAN formatted in groups of 4

error'invalid_format' | 'unsupported_country' | 'wrong_length' | 'checksum_failed'

error_detailstring

cost_usdcnumber required

processing_msnumber

Example response

{
  "country": {
    "code": "GB",
    "name": "United Kingdom"
  },
  "check_digits": "29",
  "bic": {
    "code": "NWBKGB2L"
  },
  "formatted": "GB29 NWBK 6016 1331 9268 19",
  "clearing": {
    "iid": "00230",
    "name": "UBS Switzerland AG",
    "town": "Zürich"
  },
  "cost_usdc": 0.005,
  "compliance": {
    "sanctions": {
      "matched_lists": [
        "OFAC"
      ]
    },
    "flags": [
      "fatf_grey_list",
      "emi_issuer",
      "no_vop"
    ]
  }
}