銀行くん

サービス概要

銀行くんは、日本国内の金融機関コード（銀行コード・支店コード）を検索できる無料APIサービスです。2015年の提供開始以来、会計システム、給与計算システム、金融アプリなど、幅広い業務システムでご利用いただいています。

金融機関コードは、銀行振込や口座振替などの金融取引で必須の情報ですが、手入力すると間違いやすく、ミスが発生すると振込エラーや業務遅延につながります。銀行くんを使えば、銀行名や支店名から正確なコードを即座に取得でき、入力ミスを防げます。

全国の銀行、信用金庫、信用組合、農協など、約1,400の金融機関・約13,000の支店に対応。国税庁の法人番号データとも連携し、信頼性の高い情報を提供しています。

なぜ無料で提供しているのか

金融機関コードの検索は、多くの業務システムで必要とされる基本機能です。しかし、有料APIは月額料金が高く、小規模事業者や個人開発者には導入ハードルが高いのが現状でした。

テラレンは「テクノロジーで人々の体験を最適化する」というミッションのもと、このような基本的なインフラは無料で提供すべきだと考えています。開発者が本質的な価値創造に集中できるよう、銀行くんは完全無料でご利用いただけます。

主な用途

1. 会計・経理システム

取引先への振込情報を登録する際、銀行名・支店名を入力するだけで、正しい金融機関コードを自動で取得できます。経理担当者の負担を軽減し、振込ミスを防ぎます。

2. 給与計算システム

従業員の口座情報を登録する際、銀行・支店コードの正確性を自動チェック。給与振込の失敗を未然に防ぎ、従業員の信頼を維持できます。

3. 金融アプリ・Fintechサービス

ユーザーが銀行口座を登録する際、銀行名の一部を入力するだけで候補を絞り込み表示。直感的なUIでユーザー体験を向上させます。

4. ECサイトの口座登録機能

出品者や仕入先の振込先口座情報を登録する際、銀行・支店の選択を簡単に。大量の金融機関から探す手間を削減できます。

使い方

銀行名で検索

// JavaScript (Fetch API)
const bankName = 'みずほ';

fetch(`https://bank.teraren.com/banks.json?name=${encodeURIComponent(bankName)}`)
  .then(response => response.json())
  .then(data => {
    console.log(data);
    // [
    //   {
    //     "code": "0001",
    //     "name": "みずほ銀行",
    //     "kana": "ミズホ"
    //   }
    // ]
  });

銀行コードから支店を検索

const bankCode = '0001';

fetch(`https://bank.teraren.com/banks/${bankCode}/branches.json`)
  .then(response => response.json())
  .then(data => {
    console.log(data);
    // [
    //   {
    //     "code": "001",
    //     "name": "東京営業部",
    //     "kana": "トウキヨウ",
    //     "address": "東京都千代田区..."
    //   },
    //   ...
    // ]
  });

支店名であいまい検索

const bankCode = '0001';
const branchName = '渋谷';

fetch(`https://bank.teraren.com/banks/${bankCode}/branches.json?name=${encodeURIComponent(branchName)}`)
  .then(response => response.json())
  .then(data => {
    console.log(data);
    // [
    //   {
    //     "code": "650",
    //     "name": "渋谷支店",
    //     "kana": "シブヤ",
    //     "address": "東京都渋谷区..."
    //   },
    //   {
    //     "code": "651",
    //     "name": "渋谷中央支店",
    //     "kana": "シブヤチユウオウ",
    //     "address": "東京都渋谷区..."
    //   }
    // ]
  });

Reactでの実装例

import { useState, useEffect } from 'react';

function BankSelector() {
  const [banks, setBanks] = useState([]);
  const [branches, setBranches] = useState([]);
  const [selectedBank, setSelectedBank] = useState('');
  const [searchQuery, setSearchQuery] = useState('');

  // 銀行名の候補を取得
  useEffect(() => {
    if (searchQuery.length < 2) return;

    const fetchBanks = async () => {
      const response = await fetch(
        `https://bank.teraren.com/banks.json?name=${encodeURIComponent(searchQuery)}`
      );
      const data = await response.json();
      setBanks(data);
    };

    const timer = setTimeout(fetchBanks, 300);
    return () => clearTimeout(timer);
  }, [searchQuery]);

  // 選択された銀行の支店一覧を取得
  useEffect(() => {
    if (!selectedBank) return;

    const fetchBranches = async () => {
      const response = await fetch(
        `https://bank.teraren.com/banks/${selectedBank}/branches.json`
      );
      const data = await response.json();
      setBranches(data);
    };

    fetchBranches();
  }, [selectedBank]);

  return (
    <div>
      <input
        type="text"
        value={searchQuery}
        onChange={(e) => setSearchQuery(e.target.value)}
        placeholder="銀行名を入力"
      />

      <select onChange={(e) => setSelectedBank(e.target.value)}>
        <option value="">銀行を選択</option>
        {banks.map(bank => (
          <option key={bank.code} value={bank.code}>
            {bank.name} ({bank.code})
          </option>
        ))}
      </select>

      {branches.length > 0 && (
        <select>
          <option value="">支店を選択</option>
          {branches.map(branch => (
            <option key={branch.code} value={branch.code}>
              {branch.name} ({branch.code})
            </option>
          ))}
        </select>
      )}
    </div>
  );
}

レスポンス形式

銀行検索の成功時（200 OK）

[
  {
    "code": "0001",
    "name": "みずほ銀行",
    "kana": "ミズホ",
    "type": "銀行"
  }
]

支店検索の成功時（200 OK）

[
  {
    "code": "001",
    "name": "東京営業部",
    "kana": "トウキヨウ",
    "address": "東京都千代田区大手町1-5-5",
    "postal_code": "1000004",
    "phone": "03-1234-5678"
  }
]

データの信頼性

銀行くんは、以下の公的データソースを使用しています：

• 全国銀行協会: 金融機関コード一覧
• 国税庁法人番号公表サイト: 金融機関の最新情報
• 各金融機関の公式サイト: 支店の住所・電話番号

金融機関の統廃合や支店の統合・廃止があった場合、通常2〜4週間以内にデータを更新します。重要な変更については、より早期に対応するよう努めています。

パフォーマンスとインフラ

• Cloudflare Workers: エッジコンピューティングで高速レスポンス
• あいまい検索エンジン: 部分一致・かな検索に対応
• キャッシュ最適化: よく検索される銀行は超高速表示

約13,000支店のデータを高速に検索できるよう、独自のインデックス構造を採用しています。

トラブルシューティング

検索しても結果が出ない

• 銀行名は正式名称で検索してください（例: 三菱UFJ銀行）
• 旧名称では検索できない場合があります
• 統廃合された金融機関は、新しい名称で検索してください

古い支店コードが返ってくる

• 支店の統廃合情報の反映に時間がかかる場合があります
• 最新情報が必要な場合は、お問い合わせください

あいまい検索が効かない

• 最低2文字以上入力してください
• カタカナ・ひらがな・漢字すべてに対応しています

競合サービスとの比較

今後の予定

• 金融機関の廃止・統合情報の通知機能
• 過去の銀行コード履歴の提供
• SWIFTコード対応
• 金融機関の営業時間情報

皆様のビジネスにお役立ていただけるよう、今後も機能拡充を続けていきます。ご要望があれば、お気軽にお問い合わせください。