{"openapi":"3.1.0","info":{"title":"IBAN Validation API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/iban-api","description":"oanor gateway"}],"tags":[{"name":"IBAN"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/parse":{"get":{"operationId":"get_v1_parse","tags":["IBAN"],"summary":"Local checksum + structure","description":"","parameters":[{"name":"iban","in":"query","required":true,"description":"IBAN to parse","schema":{"type":"string"},"example":"DE89370400440532013000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/validate":{"get":{"operationId":"get_v1_validate","tags":["IBAN"],"summary":"Validate + BIC + bank","description":"","parameters":[{"name":"iban","in":"query","required":true,"description":"IBAN to validate","schema":{"type":"string"},"example":"DE89370400440532013000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":250,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1200,"monthly_call_quota":6000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3400,"monthly_call_quota":35000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8900,"monthly_call_quota":150000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/iban-api"}