IBANforge

IBANforge API

Download Postman Collection

IBANforge is a fast, reliable API for IBAN validation and BIC/SWIFT lookup. It covers 80+ countries with real-time checksum verification, BBAN structure parsing, enriched institution data from GLEIF, SEPA compliance info, issuer classification (bank vs. EMI/neobank), and risk indicators for compliance agents.

Base URL

https://api.ibanforge.com

All endpoints are served over HTTPS. HTTP requests are redirected automatically.

Authentication

IBANforge uses x402 micropayments instead of traditional API keys. Each request costs a fraction of a cent, paid automatically in USDC. No signup, no subscription, no rate limits.

Your HTTP client attaches a payment header, and the API verifies it before processing. See the x402 micropayments guide for details.

Endpoints at a glance

| Endpoint | Method | Cost | Description | |---|---|---|---| | /v1/iban/validate | POST | $0.005 | Validate a single IBAN | | /v1/iban/batch | POST | $0.002/IBAN | Validate up to 100 IBANs | | /v1/bic/:code | GET | $0.003 | Look up a BIC/SWIFT code | | /v1/demo | GET | Free | Example validations (no payment needed) | | /health | GET | Free | Service health check |

Quick example

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "CH93 0076 2011 6238 5295 7"}'

Response:

{
  "iban": "CH9300762011623852957",
  "valid": true,
  "country": {
    "code": "CH",
    "name": "Switzerland"
  },
  "check_digits": "93",
  "bban": {
    "bank_code": "00762",
    "account_number": "011623852957"
  },
  "bic": {
    "code": "UBSWCHZH",
    "bank_name": "UBS SWITZERLAND AG",
    "city": "ZURICH"
  },
  "sepa": {
    "member": true,
    "schemes": ["SCT", "SDD"],
    "vop_required": false
  },
  "issuer": {
    "type": "bank",
    "name": "UBS SWITZERLAND AG"
  },
  "risk_indicators": {
    "issuer_type": "bank",
    "country_risk": "standard",
    "test_bic": false,
    "sepa_reachable": true,
    "vop_coverage": false
  },
  "formatted": "CH93 0076 2011 6238 5295 7",
  "cost_usdc": 0.005
}

Free testing

Use the /v1/demo endpoint to test the API without any payment setup:

curl https://api.ibanforge.com/v1/demo

This returns pre-validated example IBANs from multiple countries so you can explore the response format.

Next steps