{"uid":"cap_5pLjNZvz87QSseLUSAOLw","slug":"iban-validation-check-6eb88c4f","name":"IBAN Validation Check","description":"Cheapest call. Validates an IBAN (ISO 13616 mod-97 checksum, length and country) before you pay it. Returns PASSED or FAILED with a reason code. Irish (IE) IBANs pass by default.","url":"https://supplier-payment-verifier-production.up.railway.app/v1/checks/iban?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"iban":{"type":"string","title":"Iban","examples":["IE29AIBK93115212345678"],"maxLength":40,"minLength":5,"description":"IBAN to validate; spaces and lowercase are normalized. Checks checksum/length/country only, not account ownership."}}},"responseSchema":{"type":"json","example":{"iban":"IE29AIBK93115212345678","check":"IBAN","valid":true,"country":"IE","outcome":"PASSED","checked_at":"2026-10-15T12:00:00Z","reason_code":"IBAN_VALID"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wCEfvZOUXX1AcY5Zo3_WF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an IBAN string using ISO 13616 mod-97 checksum, length, and country checks, returning PASSED or FAILED with a reason code.","exampleAgentPrompt":"Before I pay this invoice, can you validate the IBAN IE29AIBK93115212345678 to make sure it passes the checksum and country check?","exampleUseCases":[{"title":"Pre-payment supplier IBAN check","prompt":"I'm about to pay a new Irish supplier — their IBAN is IE29AIBK93115212345678. Can you verify it's valid before we send the money?"},{"title":"Invoice processing automation","prompt":"We just received an invoice from a German supplier with IBAN DE89370400440532013000. Check that the IBAN is valid and passes all format checks before we queue it for payment."},{"title":"Onboarding new vendor bank details","prompt":"We're onboarding a new vendor and they've given us IBAN GB29NWBK60161331926819 — can you run a validation check to confirm the format and checksum are correct?"}],"resultDescription":"A JSON object containing the original IBAN, the check type ('IBAN'), a boolean valid flag, the detected country code, an outcome string ('PASSED' or 'FAILED'), an ISO 8601 timestamp of when the check was performed, and a reason_code (e.g. 'IBAN_VALID', or a specific failure reason such as invalid checksum or unsupported country).","failureModes":["IBAN fails mod-97 checksum — returns FAILED with reason code indicating checksum error","IBAN length does not match the expected length for the declared country — returns FAILED with length mismatch reason","Unsupported or unrecognised country code prefix — returns FAILED with country reason code","IBAN too short or too long (violates minLength 5 or maxLength 40 constraint) — HTTP 422 validation error","Malformed request body or missing iban field — HTTP 422 unprocessable entity","Payment not completed (x402 protocol) — HTTP 402 payment required"],"whenToPreferThis":"Use this endpoint when you need a lightweight, inexpensive ($0.005) IBAN format and checksum validation before executing a supplier payment, especially for Irish (IE) and other European IBANs. Prefer this over a full supplier verification workflow when you only need to confirm the bank account number itself is structurally valid, not the supplier's identity or VAT registration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:37:33.632Z","isFirstParty":false,"canonicalSlug":"iban-validation-check-6eb88c4f"}