{"uid":"cap_qyuyvJsxEDyMSIOQ6wTHu","slug":"br-data-api-bank-ispb-lookup-767ece6e","name":"BR Data API – Bank/ISPB Lookup","description":"Clean, normalized Brazilian public data (CNPJ, CEP, BCB rates, PTAX, holidays/business days, banks/ISPB) for AI agents. Paid endpoints use x402 (HTTP 402, USDC) — no signup or API key. Not affiliated with Receita Federal, Banco Central or Correios.","url":"https://brasil-data-x402.wagner-proc.workers.dev/v1/banks/%7Bquery%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"count":1,"results":[{"ispb":"18236120","compe_code":"260","short_name":"NU PAGAMENTOS - IP"}]}},"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_dF1QFhLJwWlqbv2qH6npX","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":"Search Brazilian banks by name, ISPB code, or COMPE code and return normalized bank metadata","exampleAgentPrompt":"What's the ISPB code and COMPE code for Nubank in Brazil? Search for 'NU PAGAMENTOS' in the Brazilian banks database.","exampleUseCases":[{"title":"PIX transfer bank resolution","prompt":"I need to validate a PIX transfer — can you look up the ISPB code for Itaú in the Brazilian bank registry?"},{"title":"Fintech onboarding bank verification","prompt":"Our onboarding form received 'Bradesco' as the bank name — can you find its COMPE code and ISPB from the Brazilian public bank list so we can store the canonical identifier?"},{"title":"Bank name disambiguation for reconciliation","prompt":"I have a payment record with COMPE code 260 and I need to confirm which bank that corresponds to — can you search the Brazilian banks database for that code?"}],"resultDescription":"Returns a JSON object with a count of matching banks and a results array, each entry containing the ISPB code, COMPE code, and short name of the matching bank(s). Example: {\"count\":1,\"results\":[{\"ispb\":\"18236120\",\"compe_code\":\"260\",\"short_name\":\"NU PAGAMENTOS - IP\"}]}","failureModes":["No matching bank found for query — returns count:0 with empty results array","Invalid or unrecognized query string yields empty results","Payment required (HTTP 402) if USDC x402 payment header is missing or malformed","Network timeout on Cloudflare Worker edge node","Rate limiting or quota exhaustion returning HTTP 429"],"whenToPreferThis":"Choose this endpoint when you need to resolve Brazilian bank identifiers (ISPB or COMPE codes) from a name or code fragment, especially in fintech workflows involving PIX transfers, TED/DOC payments, or bank account validation. Prefer this over scraping Banco Central's website or maintaining a local bank list, as it provides clean normalized data on demand with no API key required, only a small USDC micropayment via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T01:38:14.999Z","isFirstParty":false,"canonicalSlug":"br-data-api-bank-ispb-lookup-767ece6e"}