銀行情報API リファレンス

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

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

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バージョン間で変更ありません。検索用クエリパラメータ (下記) のみ、APIバージョン 2026-08-01 以降で有効です。

クエリパラメータ (銀行検索)この見出しへのリンク

APIバージョン 2026-08-01 以降で、銀行名・かなでの検索と業態での絞り込みができます。いずれも任意で、指定しない場合は従来どおり全件を返します。

curl サンプル (銀行検索)この見出しへのリンク

# 銀行名で検索 (前方一致)
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/bank?q=みずほ"
 
# ひらがな1文字 + 業態で絞り込み (振込先入力フォームの定番パターン)
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/bank?q=み&type=bank"

レスポンスの構造は全銀行一覧と同じです (data に該当した銀行の配列。銀行コード順)。

検索文字列の扱い (かな正規化)この見出しへのリンク

q の検索文字列は、全銀行協会のカナ表記 (全銀カナ) に合わせて次のように扱います。

• 濁点・半濁点は区別します。「は」で始まる銀行と「ば」で始まる銀行は別の結果になります
• 小さい「ゃ・ゅ・ょ・っ」と大きい「や・ゆ・よ・つ」は同一視します (全銀カナは「チユウオウ」のように大書きするため)。「しょ」でも「しよ」でも同じ結果になります
• 長音「ー」は無視します
• 「銀行」「信用金庫」などの業態接尾語は、付けても付けなくても同じ結果になります (「みずほ銀行」=「みずほ」)

検索時のステータスこの見出しへのリンク

• 検索パラメータ (q または type) を指定した場合、該当0件でも HTTP 200 で空の data を返します (検索の0件はエラーではないため。郵便番号逆引き検索と同じ扱い)
• match / type に不正な値を指定した場合は HTTP 400 を返します

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

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

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 (支店一覧)この見出しへのリンク

クエリパラメータ (支店検索)この見出しへのリンク

APIバージョン 2026-08-01 以降で、支店名・かなでの検索ができます。かな正規化・0件時のステータスは 銀行検索 と同じです (支店検索では接尾語「支店」を付けても付けなくても同じ結果になります)。

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

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/bank/0001/branches
 
# 支店名をひらがなで検索 (例: 三菱UFJ銀行の「しんじ」で始まる支店)
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/bank/0005/branches?q=しんじ"

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

⇩ このエンドポイントはバージョン間で破壊的変更あり。利用中の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"
        }
      ]
    }
  }
}

{
  "version": "2025-06-28",
  "data": {
    "bank": {
      "code": "0001",
      "name": "みずほ",
      "katakana": "ミズホ",
      "hiragana": "みずほ",
      "romaji": "mizuho"
    },
    "branches": {
      "001": {
        "code": "001",
        "name": "東京営業部",
        "katakana": "トウキヨウ",
        "hiragana": "とうきよう",
        "romaji": "toukiyou"
      },
      "004": {
        "code": "004",
        "name": "丸の内中央",
        "katakana": "マルノウチチユウオウ",
        "hiragana": "まるのうちちゆうおう",
        "romaji": "marunouchichiyuuou"
      }
    }
  }
}

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

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

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

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"
      }
    ]
  }
}

{
  "version": "2025-06-28",
  "data": {
    "bank": {
      "code": "0001",
      "name": "みずほ",
      "katakana": "ミズホ",
      "hiragana": "みずほ",
      "romaji": "mizuho"
    },
    "branch": {
      "code": "001",
      "name": "東京営業部",
      "katakana": "トウキヨウ",
      "hiragana": "とうきよう",
      "romaji": "toukiyou"
    }
  }
}

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

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"
  ]
}

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

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

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

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

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

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');
 
// 検索 (SDK v2.6.0 以降。APIバージョン 2026-08-01 を引数で指定)
const hits = await api.searchBanks({ q: 'みずほ', type: 'bank' }, '2026-08-01');
const branchHits = await api.searchBankBranches('0005', { q: 'しんじ' }, '2026-08-01');

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この見出しへのリンク

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

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

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

• ⚠️ 既知の問題 (このAPIに該当する制約・破壊的変更)
• API共通仕様

最終更新: 2026-09-18