ケンオール法人番号APIをリリースしました

2021-09-21新機能・改修リリース初出: blog.kenall.jp/entry/houjinbangou-api-release

注意

本記事は公開から3年が経過しています。最新の情報は技術仕様を参照してください。

国税庁が公開する法人番号データをAPIで提供するサービス「ケンオール法人番号API」をリリースしました。

法人番号データとは？この見出しへのリンク

法人番号とは、国税庁によって全ての法人（国内・国外合わせて500万件以上）に付与された13桁¹の固有番号です。個人に付与されるマイナンバーと異なり、法人番号のマスターデータは公開されています。国税庁は、この法人番号とそれに付随する以下の情報を合わせた基本3情報を、オープンデータとして公開しています。

商号または名称
本店または主たる事務所の所在地

ケンオール法人番号APIとは？この見出しへのリンク

法人番号データを使うことで、法人の正式な住所情報を簡単に取得できます。ケンオール法人番号APIは、この法人番号データをAPIとして提供するサービスです。ケンオール法人番号APIを使うことにより、例えば以下のようなシステムを簡単に作ることができます。

法人向けの商品・サービスのユーザー登録や資料請求フォームにおける住所補完
法人向けの配送を伴うサービス（例: 請求書の発行など）

なぜ法人番号APIを提供したのかこの見出しへのリンク

国税庁は、法人番号データそのものだけでなくAPIサービスも無償で公開しています（以下、国税庁APIと言います）。政府が無償でAPIを提供しているのに、同様のサービスを有償で提供する意味はないように見えます。しかし、国税庁APIには、以下のような課題があります。

郵送でアカウントを取得する必要がある
データのレスポンスはcsvかxml、エラーメッセージはcsv固定
完全一致に未対応で、前方一致のみ
さらに前方一致の場合、株式会社等の法人種別をユーザーが削除してから検索する必要あり²
はしご高などのJIS標準外の文字での検索に非対応。登記通りの名前で検索できない
CORSに非対応
サポートやSLAなどを提供していない

ケンオール法人番号APIは、上記の課題を全て解決しています。

ユーザー登録が簡単。全てWeb上で完結し、ユーザー登録したその日から利用可能
REST APIとして提供。レスポンスはJSONに統一
JavaScript SDK （近日提供予定）
部分一致の他、法人種別を含めた法人名の完全一致検索に対応。
株式会社込みで完全一致検索が可能。法人種別なしの完全一致検索も提供
はしご高など、JIS標準外の文字での検索に対応。登記通りの名称をコピー&ペーストしても検索が可能
CORS対応のため、フロントエンドのみで住所検索UIを実現可能
サポート、SLA、専用テナントなどの高度な非機能要件が必要なお客様向けに、エンタープライズプランのご提供³

また、法人種別や地方自治体などのファセット検索（絞り込みと集計）などにも対応しており、様々な形式での法人住所検索UIを提供することが可能となっています。

使い方この見出しへのリンク

法人番号APIには2通りの利用方法があります。法人番号での検索と法人名や住所による検索の2つです。

法人番号による検索は、以下のようなリクエストを送信します。

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

法人名や住所による検索は、以下のようなリクエストを送信します。

curl -G -H "Authorization: Token $YOUR_API_KEY" \
 --data-urlencode "q=株式会社オープンコレクター" \
 https://api.kenall.jp/v1/houjinbangou

どちらのリクエストを実行しても、以下のような法人情報がレスポンスとして返ってきます。（レスポンスの一部のみ掲載）

    {
      "sequence_number": "1391194",
      "corporate_number": "2021001052596",
      "process": "12",
      "correct": "0",
      "update_date": "2021-01-12",
      "change_date": "2021-01-04",
      "name": "株式会社オープンコレクター",
      "name_image_id": null,
      "kind": "301",
      "prefecture_name": "東京都",
      "city_name": "千代田区",
      "street_number": "麹町３丁目１２－１４麹町駅前ヒルトップ８階",
      "address_image_id": null,
      "jisx0402": "13101",
      "post_code": "1020083",
      "address_outside": "",
      "address_outside_image_id": null,
      "close_date": null,
      "close_cause": null,
      "successor_corporate_number": null,
      "change_cause": "",
      "assignment_date": "2015-10-05",
      "en_name": "",
      "en_address_line": "",
      "en_address_outside": "",
      "furigana": "オープンコレクター",
      "hihyoji": "0"
    }

使い方の詳細はドキュメントを参照してください。

法人名を検索できるAPIデモはこちら

価格とトライアルこの見出しへのリンク

法人番号APIは毎月66,000円（税込み）で利用できます。⁴ 1アカウントあたりのドメイン数やAPIリクエスト数は無制限です。アカウントを作成してから60日間はトライアルとして無償利用できますので、まずはアカウント登録してお試しください。

郵便番号APIと同様、サポート、SLA、専用テナントなどの非機能要件は付属しておりません。もしそういった要件がございましたらエンタープライズプランをご検討ください。

正確には、法人番号そのものは12桁で、これにチェックディジット1桁を付加して13桁として表されています ↩
部分一致検索では法人種別込みの検索が可能です ↩
別途有償となります ↩
2021/09/21時点。金額は予告なく変更する場合があります ↩