{"uid":"cap_jZJ4J2VldeURZlYbOXPQP","slug":"japanese-bank-branch-resolver-fb98ec5b","name":"Japanese Bank & Branch Resolver","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/resolve","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":["bank"],"properties":{"bank":{"type":"string","maxLength":100,"description":"Bank / 信用金庫 / 信用組合 / 労働金庫 / JA name in any notation (kanji, kana, romaji, with or without 銀行)"},"branch":{"type":"string","maxLength":100,"description":"Optional branch name (支店 suffix optional; ゆうちょ numeric names accepted)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"bank":{"query":"三菱UFJ銀行","canonical":"三菱UFJ","confident":true,"candidates":[{"code":"0005","kana":"ミツビシユ－エフジエイ","kind":"bank","name":"三菱ＵＦＪ","score":1,"matchedOn":"name","kanaHalfWidth":"ﾐﾂﾋﾞｼﾕｰｴﾌｼﾞｴｲ"}]},"best":{"bankCode":"0005","bankName":"三菱ＵＦＪ","confident":true,"branchCode":"341","branchName":"新宿"},"branch":{"query":"新宿支店","bankCode":"0005","canonical":"新宿","confident":true,"candidates":[{"code":"341","kana":"シンジユク","name":"新宿","score":1,"matchedOn":"name","kanaHalfWidth":"ｼﾝｼﾞﾕｸ"}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_W-DV3PSOUMLLY_8W4fQcm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Japanese bank or credit union name (in any notation) to its canonical name, bank code, and optional branch code/name","exampleAgentPrompt":"Can you look up the bank code and branch code for 新宿支店 at 三菱UFJ銀行? I need the canonical name and numeric codes for a bank transfer form.","exampleUseCases":[{"title":"Bank transfer form auto-fill","prompt":"I need to fill in a Japanese bank transfer form — can you resolve '三菱UFJ銀行' and its '新宿支店' branch to get the official bank code, branch code, and canonical kana names?"},{"title":"Validating user-entered bank details","prompt":"A user typed 'みずほ' as their bank name — can you look it up and confirm the canonical name, bank code, and whether it's a confident match before we save it?"},{"title":"Resolving credit union name from romaji input","prompt":"Someone wrote 'Joyo Bank' in romaji on a form — can you resolve that to its Japanese canonical name and bank code so I can process the payment correctly?"}],"resultDescription":"Returns a structured JSON object with: (1) a 'bank' object containing the query, canonical name, confidence flag, and ranked candidate matches each with bank code, kana reading, and match score; (2) a 'best' object with the top bank code, bank name, branch code, and branch name; (3) a 'branch' object with query, canonical branch name, confidence flag, and ranked branch candidates with codes and kana.","failureModes":["Unrecognized bank name returns low-confidence candidates or empty candidates array","Ambiguous name returns multiple candidates with no single confident match","Branch name not found for a valid bank returns bank data but empty branch candidates","Misspelled or heavily abbreviated input may fail to match confidently","Non-Japanese financial institutions (e.g. foreign banks) will likely return no results"],"whenToPreferThis":"Choose this endpoint when you need to resolve a Japanese bank or credit union name — in any notation (kanji, kana, romaji) — to its official numeric bank code and/or branch code. It handles partial names, alternate spellings, and suffix variations (e.g. with or without 銀行). Prefer it over generic text normalization endpoints when you specifically need structured financial institution data for Japanese bank transfers, form validation, or payment processing pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:34.926Z","isFirstParty":false}