銀行情報API リファレンス
要約: 日本全国の銀行・信用金庫・信用組合・JAバンクなどの金融機関コード (4桁) と支店コード (3桁) を取得するREST API。5エンドポイント (全銀行一覧 / 銀行詳細 / 支店一覧 / 支店詳細 / バージョン一覧) を提供。振込先入力フォームの自動補完に最適。
このページは技術リファレンスです。ユースケース・料金・導入事例はこちら。
エンドポイント一覧この見出しへのリンク
| メソッド | パス | 用途 |
|---|---|---|
| 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-Type | application/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一覧)この見出しへのリンク
| 名前 | 型 | 説明 | 例 |
|---|---|---|---|
version | string | データのバージョン | "2025-06-28" |
data | object | 銀行と支店データのオブジェクト (data.bank + data.branches。branches は支店コードをキーとし、オブジェクト配列を値とするマップ) | {...} |
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 が配列。同一支店コードに複数行 (合併等) が紐づく場合も正しく取得可能。
レスポンス・トップレベルフィールド (単一支店)この見出しへのリンク
| 名前 | 型 | 説明 | 例 |
|---|---|---|---|
version | string | データのバージョン | "2025-06-28" |
data | object | 銀行と支店データのオブジェクト (data.bank + data.branch。branch はオブジェクト配列) | {...} |
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"
]
}
レスポンスフィールドこの見出しへのリンク
| 名前 | 型 | 説明 | 例 |
|---|---|---|---|
versions | array<string> | 利用可能なデータバージョンの一覧 (YYYY-MM-DD 形式) | ["2025-01-01", ...] |
レスポンスフィールドこの見出しへのリンク
銀行データ・支店データ共通この見出しへのリンク
| 名前 | 型 | 説明 | 例 |
|---|---|---|---|
code | string | 銀行コード (4桁) / 支店コード (3桁) | "0001" / "001" |
name | string | 銀行名 / 支店名 (漢字) | "みずほ" |
katakana | string | カタカナ表記 | "ミズホ" |
hiragana | string | ひらがな表記 | "みずほ" |
romaji | string | ローマ字表記 | "mizuho" |
トップレベルこの見出しへのリンク
| 名前 | 型 | 説明 |
|---|---|---|
version | string | データバージョン (YYYY-MM-DD) |
data | object または array | 銀行/支店データ (単体取得時はobject、一覧時はarray) |
HTTPステータス・エラーこの見出しへのリンク
| HTTPステータス | 意味 | 典型的な原因 |
|---|---|---|
| 200 | OK | 正常にデータを取得 |
| 400 | Bad Request | 銀行コード/支店コードの桁数不正 |
| 401 | Unauthorized | APIキー未設定/無効 |
| 404 | Not Found | 該当する銀行/支店が存在しない |
| 429 | Too 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この見出しへのリンク
-
当ページからリンクを設定している第三者サイト (以下、「第三者サイト」と言います。) は各サイト管理者の責任で管理・運営されているものであり、ケンオール株式会社 (以下、「当社」と言います。) の管理下にあるものではありません。 第三者サイトの利用および内容に関するお問い合わせにつきまして、当社はご回答いたしかねます。 第三者サイトの利用によって生じたいかなる損害についても当社は責任を負いません。 ↩
最終更新: 2026-07-16