法人向けAPI

収入印紙チェッカーの判定エンジンを HTTP JSON API として呼び出せる、法人向け提供を準備しています。 現時点では一般公開しておらず、リリース時期は未定です。先行検証や法人導入のご相談は お問い合わせよりご連絡ください。

以下は提供開始時の仕様プレビューです。実装内容・パラメータ名・レート上限はリリース前に変更される可能性があります。

エンドポイント

POST https://inshizei.jp/api/v1/judge/
Content-Type: application/json

リクエスト

対応 documentSlug 一覧

• receipt領収書
• ukeoi請負契約書
• construction-ukeoi工事請負契約書
• real-estate-sale不動産売買契約書
• gyomu-itaku業務委託契約書
• land-lease土地賃貸借契約書
• loan金銭消費貸借契約書
• basic-trade売買取引基本契約書
• agency代理店契約書
• nda秘密保持契約書
• delivery-receipt物品受領書
• order-acknowledgment注文請書
• construction-subcontract工事下請契約書
• system-developmentシステム開発委託契約書
• advertising-production広告制作契約書
• design-productionデザイン制作請負契約書
• video-production動画制作請負契約書
• printing-contract印刷請負契約書
• translation-contract翻訳請負契約書
• cleaning-contractクリーニング請負契約書
• security-contract警備請負契約書
• repair-contract修理請負契約書
• lease-contractリース契約書
• business-transfer事業譲渡契約書
• sales-business-transfer営業譲渡契約書
• building-lease建物賃貸借契約書
• mortgage抵当権設定契約書
• promissory-note約束手形
• share-transfer株式譲渡契約書
• articles定款
• construction-subcontract-agreement工事下請契約書
• design-supervision-contract設計監理契約書
• website-production-contractホームページ制作請負契約書
• logo-design-contractロゴ制作請負契約書
• app-development-contractアプリ開発請負契約書
• ec-development-contractECサイト構築請負契約書
• system-maintenance-contractシステム保守契約書
• saas-subscription-agreementSaaS利用契約書
• software-license-agreementソフトウェアライセンス契約書
• copyright-transfer-agreement著作権譲渡契約書
• trademark-transfer-agreement商標権譲渡契約書
• patent-transfer-agreement特許権譲渡契約書
• franchise-agreementフランチャイズ契約書
• equipment-lease-contract機械リース契約書
• used-car-sale-agreement中古車売買契約書
• goods-sale-individual物品売買契約書（個別）
• photography-contract写真撮影請負契約書
• event-management-contractイベント運営委託契約書
• parking-lot-lease-agreement駐車場賃貸借契約書
• warehouse-lease-agreement倉庫賃貸借契約書
• mansion-sale-agreementマンション売買契約書
• land-only-sale-agreement土地売買契約書
• used-mansion-sale-agreement中古マンション売買契約書
• detached-house-sale-agreement戸建売買契約書
• management-consulting-contract経営コンサルティング契約書
• it-consulting-contractITコンサルティング契約書
• legal-advisory-contract法律顧問契約書
• tax-advisory-contract税理士顧問契約書
• accounting-advisory-contract会計顧問契約書
• individual-outsourcing-contract個別業務委託契約書
• distribution-agency-contract販売代理店契約書
• supply-agreement商品供給契約書
• employment-contract雇用契約書
• dispatch-contract-individual個別労働者派遣契約書
• business-alliance-agreement業務提携契約書
• joint-research-contract共同研究開発契約書
• joint-development-contract共同開発契約書
• clinical-trial-contract治験契約書
• donation-agreement寄付契約書
• gift-agreement贈与契約書
• trust-agreement信託契約書
• settlement-agreement和解契約書
• termination-agreement解約合意書
• memorandum-of-amendment変更覚書
• shareholders-agreement株主間契約書
• joint-venture-contract合弁契約書
• share-purchase-agreement株式買取契約書
• ma-loiM&A基本合意書
• nondisclosure-mutual双方向秘密保持契約書
• confidentiality-individual個別秘密保持覚書
• brokerage-agreement仲介契約書
• real-estate-brokerage-agreement不動産媒介契約書
• construction-completion-receipt建設工事完了確認書
• delivery-confirmation納品確認書
• quality-warranty品質保証契約書
• product-warranty-agreement製品保証契約書
• service-level-agreementSLA契約書
• cooperation-agreement業務協力契約書
• recruitment-agreement人材紹介契約書
• translation-individual-contract個別翻訳業務契約書
• cleaning-individual-contract個別清掃業務契約書
• security-individual-contract個別警備業務契約書
• building-management-contract建物管理委託契約書
• apartment-management-contractマンション管理委託契約書
• funeral-service-contract葬祭請負契約書
• wedding-service-contract結婚式請負契約書
• bank-loan-agreement銀行借入契約書
• promissory-loan-individual個人金銭消費貸借契約書
• consumer-loan-agreement消費者ローン契約書
• lease-finance-contractファイナンスリース契約書

サンプル

リクエスト

curl -X POST https://inshizei.jp/api/v1/judge/ \
  -H 'content-type: application/json' \
  -d '{
    "documentSlug": "receipt",
    "amount": 50000,
    "amountStated": true,
    "isBusinessRelated": true,
    "consumptionTaxSeparated": false
  }'

レスポンス

{
  "ok": true,
  "input": { "documentSlug": "receipt", "amount": 50000, ... },
  "result": {
    "verdict": "taxable",
    "amount": 200,
    "label": "200円",
    "documentName": "領収書",
    "ruleSetId": "receipt-default",
    "reasonLines": ["..."],
    "notes": ["..."],
    "sourceIds": ["nta-7105", "nta-7141"]
  },
  "meta": {
    "engineVersion": "1.0.0",
    "verifiedAt": "2026-04-25"
  }
}

エラーコード

• BAD_INPUT (HTTP 400): JSONボディ不正、または必須フィールドが欠けています。
• UNKNOWN_DOCUMENT_SLUG (HTTP 404): 対応していない documentSlug です。
• INVALID_API_KEY (HTTP 401): x-api-key ヘッダの値が登録されていません。
• RATE_LIMITED (HTTP 429): レート制御の上限を超えました。retry-after ヘッダの秒数だけ待ってください。

認証とレート制御（提供開始時の予定）

• 無認証で 60秒あたり 30 リクエストまで利用できる予定です。
• 商用大量利用やSLAが必要な場合は API キーを発行します。発行済みキーをお持ちの方は x-api-key: <your-key> ヘッダを付けて送信してください。キー認証時は 60秒あたり 600 リクエストまで利用できる予定です。
• すべてのレスポンスに x-ratelimit-limit、x-ratelimit-remaining、x-ratelimit-reset ヘッダが含まれます。
• 先行利用、APIキー発行、SLA付き提供のご相談は お問い合わせ よりご連絡ください。

利用上の注意

• APIの判定結果は、国税庁公表情報に基づく一般的な確認結果です。個別の税務判断を保証するものではありません。
• 印紙税額表は税制改正で更新されます。meta.verifiedAt で最終確認日を確認してください。
• 無認証で利用できますが、商用大量利用ではキャッシュおよび適切なレート制御をお願いします。