Trimix Invoice Issuer API — v1 ドキュメント

バージョン: v1（安定版）
ベースURL: https://api.trimix-data.io/v1
最終更新: 2026-05-28

概要

適格請求書発行事業者（T番号）を検証するAPIです。国税庁の公開データをもとに日次更新し、常に最新の登録状態を返します。

主なユースケース:

• 請求書の発行前にT番号の有効性を確認する
• freee・マネーフォワード等の会計SaaSと連携して自動検証を行う
• 大量の取引先T番号を一括検証してリスクを管理する

対象バージョン情報

認証

すべてのエンドポイントは x-api-key ヘッダーに有効なAPIキーが必要です。

GET /v1/invoice-issuers/T1234567890123
x-api-key: your_api_key_here

APIキーは Trimixダッシュボード から取得できます。

エンドポイント一覧

GET /v1/invoice-issuers/{t_number}

単一のT番号を検証します。

リクエスト:

GET /v1/invoice-issuers/T1234567890123
x-api-key: your_api_key_here

レスポンス（200 OK）:

{
  "t_number": "T1234567890123",
  "status": "active",
  "registrant_name": "株式会社テスト",
  "trade_name": null,
  "address": {
    "prefecture": "東京都",
    "city": "新宿区",
    "street": "西新宿1-1-1"
  },
  "registered_at": "2023-10-01T00:00:00.000Z",
  "cancelled_at": null,
  "updated_at": "2026-01-01T00:00:00.000Z"
}

パラメータ:

POST /v1/invoice-issuers/batch

最大1000件のT番号を一括検証します。

リクエスト:

POST /v1/invoice-issuers/batch
x-api-key: your_api_key_here
Content-Type: application/json

{
  "t_numbers": ["T1234567890123", "T9876543210987"]
}

レスポンス（200 OK）:

{
  "results": [
    {
      "t_number": "T1234567890123",
      "found": true,
      "data": {
        "t_number": "T1234567890123",
        "status": "active",
        "registrant_name": "株式会社テスト",
        "trade_name": null,
        "address": { "prefecture": "東京都", "city": "新宿区", "street": "西新宿1-1-1" },
        "registered_at": "2023-10-01T00:00:00.000Z",
        "cancelled_at": null,
        "updated_at": "2026-01-01T00:00:00.000Z"
      }
    },
    {
      "t_number": "T9876543210987",
      "found": false
    }
  ]
}

制限: 1リクエストあたり最大1000件

GET /v1/invoice-issuers/{t_number}/history

T番号の登録・変更履歴をカーソルページネーションで返します。

リクエスト:

GET /v1/invoice-issuers/T1234567890123/history?limit=20
x-api-key: your_api_key_here

レスポンス（200 OK）:

{
  "items": [
    {
      "changed_at": "2023-10-01T00:00:00.000Z",
      "change_type": "registered",
      "before": null,
      "after": {
        "registrant_name": "株式会社テスト",
        "status": "active"
      }
    }
  ],
  "next_cursor": null
}

クエリパラメータ:

エラーカタログ

すべてのエラーレスポンスは RFC 7807 Problem Details 形式です。

{
  "type": "https://api.trimix-data.io/errors/<error-code>",
  "title": "エラーの概要",
  "status": 400,
  "detail": "詳細メッセージ",
  "instance": "/v1/invoice-issuers/T999"
}

コードサンプル

curl

# 単一検証
curl -H "x-api-key: your_key" \
  https://api.trimix-data.io/v1/invoice-issuers/T1234567890123

# バッチ検証
curl -X POST \
  -H "x-api-key: your_key" \
  -H "Content-Type: application/json" \
  -d '{"t_numbers":["T1234567890123","T9876543210987"]}' \
  https://api.trimix-data.io/v1/invoice-issuers/batch

TypeScript

const API_KEY = process.env.TRIMIX_API_KEY;
const BASE_URL = 'https://api.trimix-data.io/v1';

// 単一検証
const response = await fetch(`${BASE_URL}/invoice-issuers/T1234567890123`, {
  headers: { 'x-api-key': API_KEY },
});
if (!response.ok) {
  const error = await response.json();
  console.error(error.detail);
}
const issuer = await response.json();

// バッチ検証
const batchResponse = await fetch(`${BASE_URL}/invoice-issuers/batch`, {
  method: 'POST',
  headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ t_numbers: ['T1234567890123', 'T9876543210987'] }),
});
const { results } = await batchResponse.json();

Python

import httpx

API_KEY = "your_api_key"
BASE_URL = "https://api.trimix-data.io/v1"

# 単一検証
response = httpx.get(
    f"{BASE_URL}/invoice-issuers/T1234567890123",
    headers={"x-api-key": API_KEY}
)
response.raise_for_status()
issuer = response.json()

レート制限

レート制限超過時は 429 Too Many Requests + rate-limit-exceeded エラーが返ります。

データ更新サイクル

このAPIのデータは国税庁「適格請求書発行事業者公表サイト」の公開データをもとに毎日更新されます。

国税庁側のシステムメンテナンス等により、取り込みが遅延する場合があります。