# IBAN Validation API
> Validate IBANs with the ISO 7064 mod-97 checksum and per-country length and structure checks, and resolve the BIC and bank details for supported countries. A local parse endpoint works for every IBAN country offline; the validate endpoint adds bank-code verification and BIC. Ideal for payments, billing, onboarding and KYC.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/iban-api/..."
```

## Pricing
- **Free** (Free) — 250 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 6,000 calls/Mo, 5 req/s
- **Pro** ($34/Mo) — 35,000 calls/Mo, 15 req/s
- **Mega** ($89/Mo) — 150,000 calls/Mo, 40 req/s

## Endpoints

### IBAN

#### `GET /v1/parse` — Local checksum + structure

**Parameters:**
- `iban` (query, required, string) — IBAN to parse Example: `DE89370400440532013000`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/iban-api/v1/parse?iban=DE89370400440532013000"
```

**Response:**
```json
{
    "data": {
        "bban": "370400440532013000",
        "iban": "DE89370400440532013000",
        "valid": true,
        "length": 22,
        "formatted": "DE89 3704 0044 0532 0130 00",
        "check_digits": "89",
        "country_code": "DE",
        "length_valid": true,
        "checksum_valid": true,
        "expected_length": 22,
        "country_supported": true
    },
    "meta": {
        "timestamp": "2026-05-30T04:03:51.305Z",
        "request_id": "5c5d5be6-4d41-4092-a19f-ccfef95069f6"
    },
    "status": "ok",
    "message": "IBAN parsed successfully",
    "success": true
}
```

#### `GET /v1/validate` — Validate + BIC + bank

**Parameters:**
- `iban` (query, required, string) — IBAN to validate Example: `DE89370400440532013000`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/iban-api/v1/validate?iban=DE89370400440532013000"
```

**Response:**
```json
{
    "data": {
        "bank": {
            "bic": "COBADEFFXXX",
            "city": "Köln",
            "name": "Commerzbank",
            "bank_code": "37040044"
        },
        "iban": "DE89370400440532013000",
        "valid": true,
        "messages": [
            "Bank code valid: 37040044"
        ],
        "formatted": "DE89 3704 0044 0532 0130 00",
        "country_code": "DE",
        "check_results": {
            "bankCode": true
        }
    },
    "meta": {
        "timestamp": "2026-05-30T04:03:51.896Z",
        "request_id": "ca2f3f4a-9631-401f-9ab1-770b92e062e9"
    },
    "status": "ok",
    "message": "IBAN validated successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/iban-api
OpenAPI spec: https://www.oanor.com/api/iban-api/openapi.json