# Japanese Bank & Branch Lookup API

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

Looks up Japanese bank and branch details (name, kana, hiragana, romaji) by 4-digit bank code and optional 3-digit branch code

## Facts

- Endpoint: GET https://x402-ja-api.onrender.com/v1/jp/bank/lookup
- Price: $0.005/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-lookup-api-5d1e62b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O8vQGht3KCg6PuDr40NQX

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-lookup-api-5d1e62b2
```

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

## When to prefer this

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.

## Known failure modes

- 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

## 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 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.

## 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": [
      "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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": "ﾄｳｷﾖｳ"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japanese-bank-branch-lookup-api-5d1e62b2/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)