{"uid":"cap_O8vQGht3KCg6PuDr40NQX","slug":"japanese-bank-branch-lookup-api-5d1e62b2","name":"Japanese Bank & Branch Lookup API","description":"Calendar and Japan data APIs for AI agents: worldwide holidays and business days (200+ countries), plus Japanese text-to-structure (address, name, bank, company normalization). Pay per call in USDC via x402, no API key.","url":"https://x402-ja-api.onrender.com/v1/jp/bank/lookup","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"],"type":"string"},"queryParams":{"type":"object","required":["bankCode"],"properties":{"bankCode":{"type":"string","pattern":"^[0-9]{4}$","description":"4-digit 金融機関コード"},"branchCode":{"type":"string","pattern":"^[0-9]{3}$","description":"Optional 3-digit 支店コード"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"bank":{"code":"0001","hira":"みずほ","kana":"ミズホ","kind":"bank","name":"みずほ","roma":"mizuho","branchCount":494,"kanaHalfWidth":"ﾐｽﾞﾎ"},"branch":{"code":"001","hira":"とうきよう","kana":"トウキヨウ","name":"東京営業部","roma":"toukiyou","kanaHalfWidth":"ﾄｳｷﾖｳ"}}},"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_FJbPluePReVzDcVMYNzqo","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":"Looks up Japanese bank and branch details (name, kana, hiragana, romaji) by 4-digit bank code and optional 3-digit branch code","exampleAgentPrompt":"What's the full name (in Japanese and romaji) for the bank with code 0001, and can you also get me the details for branch 001?","exampleUseCases":[{"title":"Wire transfer verification for Japanese accounts","prompt":"I need to verify a Japanese bank transfer — the bank code is 0005 and the branch code is 102. Can you look up the bank and branch names so I can confirm the account details are correct?"},{"title":"Financial data enrichment pipeline","prompt":"I have a list of Japanese bank codes like 0001 and 0009 — can you look each one up and give me the full bank name in Japanese, kana, and romaji so I can enrich my records?"},{"title":"Banking app onboarding form autofill","prompt":"A user just entered bank code 0033 in our Japanese banking app. Can you look it up and return the bank name in kana and romaji so we can autofill the registration form?"}],"resultDescription":"Returns a JSON object with a 'bank' object containing the bank's code, name in hiragana, katakana, half-width kana, romaji, institution kind, and total branch count. If a branchCode is provided, also returns a 'branch' object with the branch code, name, kana, half-width kana, and romaji transliteration.","failureModes":["Invalid or non-existent bankCode returns an error — must be exactly 4 digits matching a real 金融機関コード","Invalid branchCode (must be exactly 3 digits) returns a validation error","Bank code found but branch code not found returns partial or error response","Payment failure (x402 USDC not sufficient) results in 402 response before data is returned","Network timeout from the Render.com hosted service during cold start"],"whenToPreferThis":"Choose this endpoint when you need to resolve Japanese 4-digit bank codes (金融機関コード) or 3-digit branch codes (支店コード) into human-readable names in Japanese script (hiragana/katakana), half-width kana, or romaji. It is purpose-built for the Japanese banking system and returns structured multilingual representations not available from generic geocoding or international bank lookup services. Prefer it for KYC enrichment, payment form autofill, wire transfer validation, or any workflow that ingests raw Japanese bank/branch codes and needs institution metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:08.981Z","isFirstParty":false}