---
title: "認証 API key の usage / limit / plan 透明性"
method: GET
path: "/usage"
tags: ["System"]
---

# 認証 API key の usage / limit / plan 透明性

`GET /usage`

## Request

- Base URL: `https://edinetdb.jp/v1`
- URL: `https://edinetdb.jp/v1/usage`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

2026-05-23 追加。S&P Marketplace 風の usage service。
認証済 X-API-Key で plan / daily_limit / monthly_limit / today_count / month_count /
daily_remaining / monthly_remaining / created_at / daily_history (last 30 days) を返す。

per-request の今のスナップショットは response header (`X-Unit-Cost`、`X-RateLimit-Remaining`)
で取得可能。本 endpoint は cumulative aggregate 用。本 endpoint 自体も 1 req = 1 unit
(entity class 扱い)。

`plan` は内部識別子です（現在の値: `developer` = Developer プラン、`enterprise` =
Business プラン。2026-09-03 改称、識別子も **同日に `business` → `developer`
へ変更しました**。詳細は https://edinetdb.jp/legal/notice-2026-09-03-plan-ids を
ご覧ください）。顧客向けの表示名は `plan_label` を使ってください。

## Response `200`

Usage stats。`plan`（内部識別子。2026-09-03 に `business` → `developer` へ変更済み、
上記 description を参照）に加え `plan_label`（string、表示名。例: `developer` →
"Developer"）を含みます。2026-09-03〜2026-10-03 は移行期間中の旧値を
`plan_legacy`（string, nullable, deprecated。併記終了後は削除）としても返します。

## Other responses

- `401`: API key required
- `403`: Invalid or revoked API key
- `404`: Usage stats not found for this key

---

[API](https://skmtc.dev/edinetdb/apis/edinet-db-api.md) · [All operations](https://skmtc.dev/edinetdb/apis/edinet-db-api/llms.txt) · [OpenAPI document](https://skmtc.dev/edinetdb/apis/edinet-db-api/revisions/d896c5f7d472?raw)