# Japanese Bank & Branch Resolver

> Japanese Bank & Branch Resolver is a paid API for AI agents from x402-ja-api.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Resolves a Japanese bank or credit union name (in any notation) to its canonical name, bank code, and optional branch code/name

## Facts

- Endpoint: GET https://x402-ja-api.onrender.com/v1/jp/bank/resolve
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japanese-bank-branch-resolver-fb98ec5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jZJ4J2VldeURZlYbOXPQP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability japanese-bank-branch-resolver-fb98ec5b
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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": "ｼﾝｼﾞﾕｸ"
    }
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japanese-bank-branch-resolver-fb98ec5b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-ja-api.onrender.com](https://www.zero.xyz/host/x402-ja-api.onrender.com/llms.txt)