Home  /  Docs  /  bank-search

Japan Bank Search: Zengin Bank & Branch Name API

Search Japanese financial institutions or their branches by partial name. Supports kanji, kana, and romaji input. Without a bankCode, searches across all banks; with a bankCode, searches only that bank's branches.

Endpoint

GET https://torify.dev/v1/bank/search

Parameters

NameTypeRequiredDescriptionExample
name string Yes Partial name (1-50 chars) みずほ
bankCode string No 4-digit bank code (enables branch-mode search) 0001

Response example

{ "ok": true, "data": { "mode": "bank", "hits": [], "total": 0 } }

Code examples

curl

curl "https://torify.dev/v1/bank/search?name=%E3%81%BF%E3%81%9A%E3%81%BB"

TypeScript (x402-fetch)

import { wrapFetchWithPayment } from 'x402-fetch';
import { privateKeyToAccount } from 'viem/accounts';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const fetchWithPayment = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPayment(
  'https://torify.dev/v1/bank/search?name=%E3%81%BF%E3%81%9A%E3%81%BB'
);
const data = await res.json();
console.log(data); // { ok: true, data: { ... } }

Python (requests)

import requests

# Free MCP tier (no auth) or API key (X-API-Key header)
res = requests.get(
    "https://torify.dev/v1/bank/search?name=%E3%81%BF%E3%81%9A%E3%81%BB",
    headers={"X-API-Key": "your_torify_pro_key"}
)
print(res.json())

Related endpoints

← All 36 endpoints

Pricing

$0.02 per call via x402 (USDC on Base). Or use a Pro API key ($49/mo, 10,000 calls/month).
View pricing Code examples ↗