Skip to main content

適格請求書発行事業者情報取得API

info

本APIは、プレミアムプランご購読のお客様のみが利用できます。

GET /v1/invoice/:登録番号​

指定された登録番号に対応する最新の適格請求書発行事業者リソースを取得します。

リソースURL​

https://api.kenall.jp/v1/invoice/:登録番号

パラメーター​

名前型必須かどうか説明例
:登録番号string必須国税庁によって適格請求書発行事業者ごとに付与された、Tで始まる14文字の登録番号"T2021001052596"

レスポンス​

以下は適格請求書発行事業者データのレスポンスの一例です。

{
  "version": "2022-02-22",
  "data": {
    "published_date": "2024-01-31",
    "sequence_number": 105653,
    "qualified_invoice_issuer_number": "T2021001052596",
    "process": 1,
    "correct": 0,
    "kind": 2,
    "latest": 1,
    "registration_date": "2023-10-01",
    "update_date": "2022-03-02",
    "disposal_date": null,
    "expire_date": null,
    "address": {
      "postal_code": null,
      "jisx0402": "13101",
      "prefecture": "東京都",
      "prefecture_kana": "トウキョウト",
      "prefecture_roman": "Tokyo",
      "city": "千代田区",
      "city_kana": "チヨダク",
      "city_roman": "Chiyoda-ku",
      "street_number": "麹町３丁目１２－１４麹町駅前ヒルトップ８階",
      "town": "麹町",
      "kyoto_street": null,
      "block_lot_num": "3-12-14",
      "building": "麹町駅前ヒルトップ",
      "floor_room": "8階"
    },
    "address_request": null,
    "address_inside": null,
    "kana": "",
    "name": "株式会社オープンコレクター",
    "trade_name": "",
    "popular_name_previous_name": ""
  }
}

レスポンスのデータは以下のような構成になっています。

名前型説明例
versionstringデータのバージョン番号。YYYY-MM-DD形式のデータ作成日付となっている。"2022-01-31"
dataobject適格請求書発行事業者レコード後述

data内の適格請求書発行事業者レコードは以下のような構成になっています。

名前型説明例
published_datestring国税庁のサイトに記載の更新日。"2021-01-04"
sequence_numbernumber同一の適格請求書発行事業者レコードについての変更履歴番号。発行事業者ごとに数字が大きい方が最新。 (採番はソースとなるファイル毎に行われるため、異なる事業者のレコードの間で大小は一貫していないことに留意。) 左にゼロを詰めない数字で、最大桁数8桁で表される。1391194
qualified_invoice_issuer_numberstring国税庁によって適格請求書発行事業者に付与された登録番号"T2021001052596"
processnumber処理区分。1:新規、2:公表内容の変更、3:登録の失効、4:登録の抹消、99:削除2
correctnumberまたはnull訂正区分。 0:訂正以外、1:訂正、null:削除0
kindnumber人格区分。1:個人、2:法人 (「人格のない社団等」を含む)2
registration_datestringYYYY-MM-DD形式の、適格請求書発行事業者として登録された年月日。"2021-01-04"
update_datestringYYYY-MM-DD形式の更新年月日。"2021-01-12"
disposal_datestringまたはnullYYYY-MM-DD形式の取消年月日。"2021-01-12"
expire_datestringまたはnullYYYY-MM-DD形式の失効年月日。"2021-01-12"
latestnumber最新のレコードか否かを示す。0:過去情報、1:最新情報1
namestring氏名または名称1"株式会社オープンコレクター"
kanastring国外事業者が適格請求書発行事業者である場合、「氏名又は名称」の「日本語 (カナ) 表記」を表す。振りガナではないことに注意"オープンコレクター"
trade_namestring主たる屋号1"..."
popular_name_previous_namestring通称・旧姓1"..."
addressobjectまたはnull法人 (人格のない社団等を除く) の本店、または主たる事務所の所在地を表すサブレコード。1
address_requestobjectまたはnull『適格請求書発行事業者の公表事項の公表 (変更) 申請書』に記載された「主たる事務所の所在地等」 (個人の場合) あるいは「本店又は主たる事務所の所在地等」 (人格のない社団等の場合) を表すサブレコード。1
address_insideobjectまたはnull適格請求書発行事業者のうち、特定国外事業者以外の国外事業者の「国内において行う資産の譲渡等に係る事務所、事業所その他これらに準ずるもの所在地」を表すサブレコード。1

address、address_request、address_inside内のレコードは以下のような構成になっています。

名前型説明例
postal_codestringまたはnull住所情報から逆引きした郵便番号。2・3"1020083"
jisx0402stringまたはnull国内所在地の全国地方公共団体コード 3"13101"
prefecturestringまたはnull国内所在地の都道府県名 3"東京都"
prefecture_kanastringまたはnull国内所在地の都道府県名 (全角カナ) 3"トウキョウト"
prefecture_romanstringまたはnull国内所在地の都道府県名 (ローマ字表記) 3"Tokyo"
citystringまたはnull国内所在地の市区町村および行政区 3"千代田区"
city_kanastringまたはnull国内所在地の市区町村および行政区 (全角カナ) 3"チヨダク"
city_romanstringまたはnull国内所在地の市区町村および行政区 (ローマ字表記) 3"Chiyoda-ku"
street_numberstring国内事業者の場合は、国内所在地の町域以下の住所 (丁目番地等)。国外事業者の場合は住所を表す文字列全体となる。"麹町３丁目１２－１４麹町駅前ヒルトップ８階"
townstringまたはnullstreet_numberを構成する、国内所在地住所の町名。存在しない場合は空文字あるいはnullになる。3"麹町"
kyoto_streetstringまたはnullstreet_numberを構成する、国内所在地住所に含まれる京都の通り名。存在しない場合は空文字あるいはnullになる。3"先斗町通四条上る"
block_lot_numstringまたはnullstreet_numberを構成する、国内所在地住所の号番地。存在しない場合は空文字あるいはnullになる。3"3-12-14"
buildingstringまたはnullstreet_numberを構成する、国内所在地住所のビル名。存在しない場合は空文字あるいはnullになる。3"麹町駅前ヒルトップ"
floor_roomstringまたはnullstreet_numberを構成する、国内所在地住所の階層及び部屋番号。存在しない場合は空文字あるいはnullになる。3"8階"
  1. 現時点では、適格請求書発行事業者が個人である場合、レコード値はnullまたは空文字列となります。↩
  2. 国外事業者の場合はnullとなります。↩
  3. 現時点では、正確性の確認が困難であることから、空文字列もしくはnullを返します。↩