{"uid":"cap_sUy8XTO7Y1K4g7cV3nY4k","slug":"fin-codes-api-iban-lookup-validation-1d6c9920","name":"Fin Codes API – IBAN Lookup & Validation","description":"Validate IBANs, BIC/SWIFT codes and local bank routing codes worldwide with one REST API. ABA, BSB, IFSC, CLABE, NCC, Canadian routing numbers and more, plus payee verification and sanctions screening.","url":"https://api.fincodesapi.com/x402/iban/lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"iban":{"type":"string","example":"DE75512108001245126199","description":"International Bank Account Number (IBAN) to validate and look up."}}},"responseSchema":{"type":"json","example":{"data":{"id":"DE75512108001245126199","bic":{"id":"SOGEDEFF","bank":{"id":"cfb1758f-1195-4be9-b981-3fc63da7306b","code":"SOGE","name":"SOCIETE GENERALE S.A.","country_id":"DE"},"city":{"id":"c3eb05ae-2709-45c7-9799-d5e2fee08946","name":"Frankfurt Am Main","country_id":"DE"},"address":"NEUE MAINZER STRASSE 46-50","country":{"id":"DE","name":"Germany"},"postcode":"60311","branch_code":"","branch_name":"SOGEBANK Frankfurt Main"},"country":{"id":"DE","name":"Germany"},"account_number":"1245126199","national_bank_code":"51210800","national_branch_code":""},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5qwXieM-8bI5L4Te--dKg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an IBAN and returns full bank details including BIC/SWIFT code, bank name, branch, city, country, and national bank codes","exampleAgentPrompt":"Can you validate this IBAN for me — DE75512108001245126199 — and tell me which bank and branch it belongs to, including the BIC/SWIFT code?","exampleUseCases":[{"title":"Pre-payment IBAN verification for wire transfer","prompt":"Before I send this international wire transfer, can you validate the IBAN GB29NWBK60161331926819 and confirm the bank name and BIC code so I know it's correct?"},{"title":"Payee bank detail resolution for onboarding","prompt":"We're onboarding a new supplier who gave us IBAN FR7630006000011234567890189 — can you look it up and tell me the bank name, BIC/SWIFT code, and branch details?"},{"title":"Finance team IBAN audit check","prompt":"I need to verify this IBAN is real and get its full bank details for our records: ES9121000418450200051332. What bank does it belong to and what's the BIC?"}],"resultDescription":"Returns a JSON object with a success flag and a data object containing: the IBAN as id, BIC details (BIC code, bank name, bank code, country), branch information (name, address, city, postcode), country details, parsed account number, national bank code, and national branch code.","failureModes":["Invalid IBAN format returns success:false with validation error","Unknown or unsupported IBAN country prefix may return no bank data","Malformed request body returns HTTP 400","Payment failure or insufficient USDC balance blocks the call via x402 protocol","Network timeout if upstream bank registry is unavailable"],"whenToPreferThis":"Choose this endpoint when you need to validate an IBAN and simultaneously retrieve structured bank metadata (BIC, bank name, branch, address) in a single call. It is especially useful for pre-payment verification, supplier onboarding, compliance checks, and any workflow requiring both format validation and bank identity confirmation. Covers international IBANs globally with support for local routing codes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:31:02.012Z","isFirstParty":false,"canonicalSlug":"fin-codes-api-iban-lookup-validation-1d6c9920"}