適格請求書発行事業者API (インボイスAPI) リファレンス

エンドポイント一覧この見出しへのリンク

共通仕様この見出しへのリンク

GET /v1/invoice/{登録番号}この見出しへのリンク

リソースURLこの見出しへのリンク

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

パスパラメータこの見出しへのリンク

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/invoice/T2021001052596

レスポンス例この見出しへのリンク

現行APIバージョン (2024-01-01 単一)。本番kenall.jpと同じ構造で表示。

{
  "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": ""
  }
}

レスポンス・トップレベルフィールドこの見出しへのリンク

data オブジェクトのフィールド仕様 (19フィールド)この見出しへのリンク

address / address_request / address_inside オブジェクトのフィールド仕様 (15フィールド)この見出しへのリンク

HTTPステータス・エラーこの見出しへのリンク

SDK で呼び出すこの見出しへのリンク

import { KENALL } from '@ken-all/kenall';
const api = new KENALL('YOUR_API_KEY');
 
const result = await api.getInvoiceIssuer('T2021001052596');
console.log(result.data.name);                              // => 株式会社オープンコレクター
console.log(result.data.disposal_date === null);             // => true (有効)
console.log(result.data.qualified_invoice_issuer_number);    // => "T2021001052596"
// 法人番号はT番号の数字部分 (後ろ13桁)
const corporateNumber = result.data.qualified_invoice_issuer_number.slice(1);
console.log(corporateNumber);                                // => "2021001052596"

このAPIに関する技術FAQこの見出しへのリンク

OpenAPI スキーマこの見出しへのリンク

OpenAPI スキーマ (YAML): 2024-01-01 / 2025-01-01

関連リファレンスこの見出しへのリンク

• ⚠️ 既知の問題 (このAPIに該当する制約・破壊的変更)
• API共通仕様
• 法人番号API — 法人番号からインボイス登録番号への変換

外部参考リソースこの見出しへのリンク

• 国税庁『適格請求書発行事業者公表サイト』 — 元データの出典

最終更新: 2026-07-14