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

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

法人番号データとは?

法人番号とは、国税庁によって全ての法人(国内・国外合わせて500万件以上)に付与された13桁*1の固有番号です。個人に付与されるマイナンバーと異なり、法人番号のマスターデータは公開されています。 国税庁は、この法人番号とそれに付随する以下の情報を合わせた基本3情報を、オープンデータとして公開しています。 - 商号または名称 - 本店または主たる事務所の所在地

ケンオール法人番号APIとは?

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

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

なぜ法人番号APIを提供したのか

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

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

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

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

また、法人種別や地方自治体などのファセット検索(絞り込みと集計)などにも対応しており、様々な形式での法人住所検索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": "麹町3丁目12-14麹町駅前ヒルトップ8階",
      "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は毎月66,000円(税込み)で利用できます。*4 1アカウントあたりのドメイン数やAPIリクエスト数は無制限です。 アカウントを作成してから60日間はトライアルとして無償利用できますので、まずはアカウント登録してお試しください。

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

ケンオールについて

「かゆいところにケンオール」 ケンオールは、郵便番号住所検索API、法人番号APIをはじめとした、システム開発を加速する高品質で安全なAPIサービスです。 kenall.jp

Shodoで執筆されました

*1:正確には、法人番号そのものは12桁で、これにチェックディジット1桁を付加して13桁として表されています

*2:部分一致検索では法人種別込みの検索が可能です

*3:別途有償となります

*4:2021/09/21時点。金額は予告なく変更する場合があります