銀行情報APIに銀行名・かなでの検索を追加しました

銀行情報APIに、銀行名・かなでの検索機能を追加しました。APIバージョン 2026-08-01 以降で利用できます。

これまで銀行情報APIは、4桁の金融機関コードが分かっていることが前提でした。今回の追加で、銀行一覧・支店一覧をクエリパラメータ q で絞り込めるようになり、コードが分からなくても名前から引けるようになりました。

できるようになったことこの見出しへのリンク

• 銀行名・かなで検索: GET /v1/bank?q=みずほ のように、銀行名 (漢字) でもかな (カタカナ・ひらがな) でも検索できます
• ひらがな1文字から: 銀行のアプリでよくある「ひらがなで1文字入力してください」という振込先フォームがそのまま作れます (?q=み)
• 業態での絞り込み: type=bank (銀行・ゆうちょ銀行) / shinkin (信用金庫) / shinkumi_rokin (信用組合・労働金庫) / nokyo_gyokyo (農協・漁協) で候補を絞れます
• 支店も検索: GET /v1/bank/0005/branches?q=しんじ のように、支店名・かなでも絞り込めます

curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/bank?q=み&type=bank&-kenall-api-version=2026-08-01"

検索は前方一致が既定で、match=contains を付けると部分一致になります。濁点・半濁点は区別し、小さい「ゃゅょっ」と長音は同一視します。「銀行」「信用金庫」などの業態接尾語は付けても付けなくても同じ結果になります。

該当が0件の場合もエラーではなく、HTTP 200 で空の data を返します。

利用にあたってこの見出しへのリンク

• APIバージョン 2026-08-01 以降で有効です。バージョンは KenAll-API-Version ヘッダ、クエリパラメータ -kenall-api-version、またはAPIキーのデフォルト設定で指定できます (APIバージョニング)
• 2025-01-01 以前のバージョンを指定した場合、検索パラメータは無視され、従来どおり全件が返ります (既存の実装には影響ありません)
• 銀行情報APIはスタンダードプラン以上でご利用いただけます

詳細な仕様は 銀行情報API リファレンス をご覧ください。銀行情報APIの紹介ページ では、実際のレスポンスをその場で試せるデモを用意しています。