IBAN Validation API

GET /validate

Validate an IBAN and extract its components.

GET https://iban-validator-api.zivtools.workers.dev/validate?iban=DE89370400440532013000&apikey=demo-key-123

{
  "valid": true,
  "iban": "DE89370400440532013000",
  "country": "Germany",
  "countryCode": "DE",
  "bankCode": "37040044",
  "branchCode": "",
  "accountNumber": "0532013000",
  "checkDigits": "89",
  "bban": "370400440532013000",
  "isSepa": true
}

GET /generate

Generate a sample IBAN for testing.

GET https://iban-validator-api.zivtools.workers.dev/generate?country=GB&bankCode=NWBK&apikey=demo-key-123

{
  "iban": "GB82NWBK60161331926819",
  "country": "United Kingdom",
  "formatted": "GB82 NWBK 6016 1331 9268 19"
}

GET /countries

List all supported countries with IBAN format details. No authentication required.

GET https://iban-validator-api.zivtools.workers.dev/countries

{
  "count": 80,
  "countries": [
    { "code": "DE", "name": "Germany", "ibanLength": 22, "isSepa": true, "example": "DE89370400440532013000" },
    ...
  ]
}

GET /bic

Lookup BIC/SWIFT code from an IBAN.

GET https://iban-validator-api.zivtools.workers.dev/bic?iban=GB29NWBK60161331926819&apikey=demo-key-123

{
  "bic": "NWBKGB2LXXX",
  "bankName": "NatWest",
  "city": "London",
  "country": "United Kingdom"
}

POST /batch

Validate up to 100 IBANs in a single request.

POST https://iban-validator-api.zivtools.workers.dev/batch
Content-Type: application/json
X-API-Key: demo-key-123

{ "ibans": ["DE89370400440532013000", "GB29NWBK60161331926819", "INVALID123"] }

{
  "count": 3,
  "results": [
    { "valid": true, "iban": "DE89370400440532013000", "country": "Germany", ... },
    { "valid": true, "iban": "GB29NWBK60161331926819", "country": "United Kingdom", ... },
    { "valid": false, "iban": "INVALID123", "errors": ["Unknown country code: IN"] }
  ]
}

cURL

curl "https://iban-validator-api.zivtools.workers.dev/validate?iban=DE89370400440532013000" \
  -H "X-API-Key: demo-key-123"

JavaScript

const response = await fetch(
  'https://iban-validator-api.zivtools.workers.dev/validate?iban=DE89370400440532013000',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const data = await response.json();
console.log(data.valid, data.country, data.bankCode);

Python

import requests

resp = requests.get(
    'https://iban-validator-api.zivtools.workers.dev/validate',
    params={'iban': 'DE89370400440532013000'},
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(resp.json())