{"uid":"cap_ENbdrEljdruuCt6AL7ifM","slug":"bank-validate-416c3474","name":"bank-validate","description":"Cheap structural IBAN validation: ISO 13616 checksum + per-country structure/length. Returns valid plus, on rejection, a granular error_type (invalid_checksum, invalid_length, invalid_structure, invalid_country), the country and the format spec. Offline (schwifty, MIT); no network or keys. A cheap-first entry before the fuller /bank/verify fusion route.","url":"https://payai.agentstools.dev/bank/validate","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["iban"],"properties":{"iban":{"type":"string","description":"IBAN to validate (spaces optional, any case)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_330Fk7IrEqETu0RKsAdsV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an IBAN structurally offline using ISO 13616 checksum and per-country format rules, returning validity status and granular error details on failure","exampleAgentPrompt":"Can you check whether this IBAN is structurally valid: DE89370400440532013000? If it's not valid, tell me what specifically is wrong with it.","exampleUseCases":[{"title":"Payment form IBAN pre-check","prompt":"Before I submit this wire transfer, can you validate that GB29NWBK60161331926819 is a correctly formatted IBAN and tell me if anything is wrong with the checksum or structure?"},{"title":"Bulk onboarding data quality check","prompt":"I'm importing customer bank details and one record has the IBAN FR7614508059325840897L26071 — can you do a quick structural check to see if it's valid and what the error is if not?"},{"title":"Debugging a rejected payment IBAN","prompt":"A payment I tried to send got rejected — the destination IBAN was NL91ABNA041716430. Can you validate it structurally and tell me whether the checksum or format is wrong?"}],"resultDescription":"Returns a JSON object containing a boolean 'valid' field. On failure, includes a granular 'error_type' (one of: invalid_checksum, invalid_length, invalid_structure, invalid_country), the detected country code, and the expected format specification for that country. On success, may include country and format info as well. The check is entirely offline with no network calls.","failureModes":["Malformed or empty IBAN input may return invalid_structure","Unknown or unsupported country code yields invalid_country error","IBAN with correct structure but wrong checksum returns invalid_checksum","IBAN with wrong length for its country returns invalid_length","Spaces and case variations are normalized — passing raw user input is safe","This endpoint does NOT verify account existence or bank reachability — use /bank/verify for that"],"whenToPreferThis":"Choose this endpoint when you need a fast, cheap, offline first-pass IBAN check before committing to a more expensive live bank verification call. It costs $0.003 USDC with no API keys or network dependencies, making it ideal as a pre-flight step in payment pipelines, form validation, or data quality checks. Prefer this over /bank/verify when you only need structural validity and don't need to confirm the account actually exists at a bank.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:10:57.242Z","isFirstParty":false}