重要なお知らせ吸収分割公告 — ケンオール事業の権利義務承継についてお知らせ一覧 →

銀行情報API リファレンス

要約: 日本全国の銀行・信用金庫・信用組合・JAバンクなどの金融機関コード (4桁) と支店コード (3桁) を取得するREST API。5エンドポイント (全銀行一覧 / 銀行詳細 / 支店一覧 / 支店詳細 / バージョン一覧) を提供。振込先入力フォームの自動補完に最適。

情報

このページは技術リファレンスです。ユースケース・料金・導入事例はこちら

情報

※ 銀行情報データは、「角ちゃんのページ1」様にデータの利用をお願いし、ご快諾いただいた上で、これをベースに弊社独自の更新検知や加工を行い、APIとして提供しています。

エンドポイント一覧この見出しへのリンク

メソッドパス用途
GET/v1/bank全銀行一覧
GET/v1/bank/{銀行コード}特定銀行情報取得
GET/v1/bank/{銀行コード}/branches銀行の全支店一覧
GET/v1/bank/{銀行コード}/branches/{支店コード}特定支店情報取得
GET/v1/bank/versionsデータバージョン一覧

共通仕様この見出しへのリンク

項目内容
認証Authorization: Token YOUR_API_KEY
データソース金融機関コード一覧 (第三者管理サイト「角ちゃんのページ」様にデータ利用をご快諾いただき、独自更新検知)
プラン本APIはスタンダードプラン以上でご利用いただけます (詳細は 料金プラン)
Content-Typeapplication/json
警告

APIバージョン 2025-01-01 で破壊的変更: 同一支店コードに複数支店が紐づくケース (合併・統合等) に対応するため、branches 配下が オブジェクト → 配列に変更されました。

2024-01-01: branches["001"] = 単一オブジェクト / 2025-01-01: branches["001"] = オブジェクト配列

GET /v1/bank (全銀行一覧)この見出しへのリンク

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/bank

レスポンス例この見出しへのリンク

{
  "version": "2025-06-28",
  "data": [
    {"code": "0001", "name": "みずほ", "katakana": "ミズホ", "hiragana": "みずほ", "romaji": "mizuho"},
    {"code": "0005", "name": "三菱UFJ", "katakana": "ミツビシユーエフジエイ", "hiragana": "みつびしゆーえふじえい", "romaji": "mitsubishiyu-efujiei"},
    {"code": "0009", "name": "三井住友", "katakana": "ミツイスミトモ", "hiragana": "みついすみとも", "romaji": "mitsuisumitomo"}
  ]
}

📌 全銀行一覧エンドポイントは APIバージョン間で構造変更なし (バージョン非依存)。

GET /v1/bank/{銀行コード}この見出しへのリンク

パスパラメータこの見出しへのリンク

名前必須説明
{銀行コード}string必須4桁の金融機関コード"0001"

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/bank/0001

レスポンス例この見出しへのリンク

{
  "version": "2025-06-28",
  "data": {
    "code": "0001",
    "name": "みずほ",
    "katakana": "ミズホ",
    "hiragana": "みずほ",
    "romaji": "mizuho"
  }
}

📌 単一銀行取得エンドポイントは APIバージョン間で構造変更なし。

GET /v1/bank/{銀行コード}/branches (支店一覧)この見出しへのリンク

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/bank/0001/branches

レスポンス例この見出しへのリンク

このエンドポイントはバージョン間で破壊的変更あり。利用中のAPIバージョンタブを選択してください。

{
  "version": "2025-06-28",
  "data": {
    "bank": {
      "code": "0001",
      "name": "みずほ",
      "katakana": "ミズホ",
      "hiragana": "みずほ",
      "romaji": "mizuho"
    },
    "branches": {
      "001": [
        {
          "name": "東京営業部",
          "katakana": "トウキヨウ",
          "hiragana": "とうきよう",
          "romaji": "toukiyou"
        },
        {
          "code": "001",
          "name": "東京都庁公営企業出張所",
          "katakana": "トウキヨウトチヨウコウエイ",
          "hiragana": "とうきようとちようこうえい",
          "romaji": "toukiyoutochiyoukouei"
        }
      ],
      "004": [
        {
          "code": "004",
          "name": "丸の内中央",
          "katakana": "マルノウチチユウオウ",
          "hiragana": "まるのうちちゆうおう",
          "romaji": "marunouchichiyuuou"
        }
      ]
    }
  }
}

📌 branches["001"]オブジェクト配列。合併・統合で同一支店コードに複数行が紐づくケース (“001”に2件) に対応。

レスポンス・トップレベルフィールド (branches一覧)この見出しへのリンク

名前説明
versionstringデータのバージョン"2025-06-28"
dataobject銀行と支店データのオブジェクト (data.bank + data.branchesbranches は支店コードをキーとし、オブジェクト配列を値とするマップ){...}

GET /v1/bank/{銀行コード}/branches/{支店コード}この見出しへのリンク

パスパラメータこの見出しへのリンク

名前必須説明
{銀行コード}string必須4桁の金融機関コード"0001"
{支店コード}string必須3桁の支店コード"001"

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/bank/0001/branches/001

レスポンス例この見出しへのリンク

このエンドポイントもバージョン間で破壊的変更ありbranch がオブジェクト→配列に変わります。

{
  "version": "2025-06-28",
  "data": {
    "bank": {
      "code": "0001",
      "name": "みずほ",
      "katakana": "ミズホ",
      "hiragana": "みずほ",
      "romaji": "mizuho"
    },
    "branch": [
      {
        "code": "001",
        "name": "東京営業部",
        "katakana": "トウキヨウ",
        "hiragana": "とうきよう",
        "romaji": "toukiyou"
      },
      {
        "code": "001",
        "name": "東京都庁公営企業出張所",
        "katakana": "トウキヨウトチヨウコウエイ",
        "hiragana": "とうきようとちようこうえい",
        "romaji": "toukiyoutochiyoukouei"
      }
    ]
  }
}

📌 branch配列。同一支店コードに複数行 (合併等) が紐づく場合も正しく取得可能。

レスポンス・トップレベルフィールド (単一支店)この見出しへのリンク

名前説明
versionstringデータのバージョン"2025-06-28"
dataobject銀行と支店データのオブジェクト (data.bank + data.branchbranchオブジェクト配列){...}

GET /v1/bank/versionsこの見出しへのリンク

利用可能なデータバージョン一覧を取得します。

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/bank/versions

レスポンス例この見出しへのリンク

{
  "versions": [
    "2025-01-01",
    "2025-01-05",
    "2025-01-08",
    "2025-01-12",
    "2025-06-28"
  ]
}

レスポンスフィールドこの見出しへのリンク

名前説明
versionsarray<string>利用可能なデータバージョンの一覧 (YYYY-MM-DD 形式)["2025-01-01", ...]

レスポンスフィールドこの見出しへのリンク

銀行データ・支店データ共通この見出しへのリンク

名前説明
codestring銀行コード (4桁) / 支店コード (3桁)"0001" / "001"
namestring銀行名 / 支店名 (漢字)"みずほ"
katakanastringカタカナ表記"ミズホ"
hiraganastringひらがな表記"みずほ"
romajistringローマ字表記"mizuho"

トップレベルこの見出しへのリンク

名前説明
versionstringデータバージョン (YYYY-MM-DD)
dataobject または array銀行/支店データ (単体取得時はobject、一覧時はarray)

HTTPステータス・エラーこの見出しへのリンク

HTTPステータス意味典型的な原因
200OK正常にデータを取得
400Bad Request銀行コード/支店コードの桁数不正
401UnauthorizedAPIキー未設定/無効
404Not Found該当する銀行/支店が存在しない
429Too Many Requestsリクエスト量の制限超過

SDK で呼び出すこの見出しへのリンク

JavaScript SDKこの見出しへのリンク

import { KENALL } from '@ken-all/kenall';
const api = new KENALL('YOUR_API_KEY');
 
const bank = await api.getBank('0001');
const branches = await api.getBankBranches('0001');
const branch = await api.getBankBranch('0001', '001');

Python (振込先連動セレクトボックス例)この見出しへのリンク

import os, requests
HEADERS = {"Authorization": f"Token {os.environ['KENALL_API_KEY']}"}
 
# 銀行一覧でセレクトボックス埋め
banks = requests.get("https://api.kenall.jp/v1/bank", headers=HEADERS).json()["data"]
 
# 選ばれた銀行の支店一覧を取得
def get_branches(bank_code):
    return requests.get(
        f"https://api.kenall.jp/v1/bank/{bank_code}/branches",
        headers=HEADERS,
    ).json()["data"]

このAPIに関する技術FAQこの見出しへのリンク

銀行コード・支店コードは数値型と文字列型のどちらで扱うべき?

必ず文字列型で扱ってください。銀行コード (例: "0001") ・支店コード (例: "001") は先頭にゼロが含まれます。数値型では先頭ゼロが失われます。

信用金庫・信用組合・JAバンクも含まれますか?

はい。日本国内の主要な金融機関 (銀行・信用金庫・信用組合・労働金庫・JAバンク等) を対象としています。

振込先入力フォームでよくある実装は?

「銀行名セレクトボックス → 支店名セレクトボックス (連動)」が典型。/v1/bank で銀行一覧、選択後に /v1/bank/{code}/branches で支店一覧を取得。Vue/React の連動セレクトで実装します。

廃止された銀行・統廃合された銀行コードは?

過去の統廃合により廃止された銀行コードは検索対象外です。最新の有効なコードのみ返却します。

ローマ字表記の規則は?

金融機関コードに準拠したローマ字表記です。一般的なヘボン式と異なるケースもあります。

OpenAPI スキーマこの見出しへのリンク

OpenAPI スキーマ (YAML): 2023-09-01 / 2024-01-01 / 2025-01-01

関連リファレンスこの見出しへのリンク

Footnotesこの見出しへのリンク

  1. 当ページからリンクを設定している第三者サイト (以下、「第三者サイト」と言います。) は各サイト管理者の責任で管理・運営されているものであり、ケンオール株式会社 (以下、「当社」と言います。) の管理下にあるものではありません。 第三者サイトの利用および内容に関するお問い合わせにつきまして、当社はご回答いたしかねます。 第三者サイトの利用によって生じたいかなる損害についても当社は責任を負いません。

最終更新: 2026-07-16