Usage and Cost Analytics API

モデル、ワークスペース、API キー、各リクエストの背後にいるユーザーやサービスアカウントなど、指定した軸ごとに内訳を出せます。利用量は GET /v1/organizations/analytics/usage がトークン数とリクエスト数を返し、コストは GET /v1/organizations/analytics/cost が USD 建ての金額を返します。社内のダッシュボードや財務レポートのために、利用状況をプログラムから集計する場面に関わる機能です。

Usage and Cost Analytics API は、/v1/organizations/analytics/usage と /v1/organizations/analytics/cost の 2 つのエンドポイントで構成されます。対象は Claude Console と Claude Enterprise の組織のトークン利用量とコストです。

• GET /v1/organizations/analytics/usage: トークン数とリクエスト数を返します。
• GET /v1/organizations/analytics/cost: USD 建てのコストを返します。/usage エンドポイントと同じ絞り込み、軸、時間の区切りを指定できます。

• 内訳に使う軸は group_by[] で指定します。指定できる軸は最大 5 つです。group_by[] に含めていない軸は、結果の group の中で null になります。指定した軸でも、その軸の値を持たない行では null になります (例: コード実行の利用量における model)。
• time_bucket_width に 1m、1h、1d のいずれかを設定すると、軸の組み合わせごとの結果を UTC の区切りで分割します。各行の starting_at と ending_at が、その区切りの範囲を示します。利用量やコストが無い区切りの行は出力されません。
• 時系列を作るときは、time_bucket_width と order_by=time を設定します。
• グループ化できる軸の多くには、models[]=claude-opus-5-5 のような角括弧表記の絞り込みが用意されています。複数の値はパラメーターを繰り返して渡し、最大 100 個まで指定できます。同じ絞り込みの複数の値は OR で、異なる絞り込み同士は AND で組み合わされます。

actor 軸は、リクエストが誰に帰属するかを表します。帰属先は次のいずれかです。

• ユーザー
• サービスアカウント
• フェデレーションされたクラウド ID (クラウドプラットフォーム経由で Claude を利用する組織の、AWS または Google Cloud のプリンシパル)
• 上のどれにも当たらない場合は、API キーそのもの

Claude Code のユーザー別コストを取得するには、コストのエンドポイントに products[]=claude_code&group_by[]=actor を付けて呼び出します。

コストのエンドポイントでは、各行の cost オブジェクトに次の値が入ります。

• amount: 割引の適用後、クレジットの適用前のコスト
• list_amount: 定価でのコスト
• currency: 常に "USD"
• requests

コストのエンドポイントに限り、group_by[]=cost_type で各行をコストの種類ごとに分割できます。group_by[]=token_type を指定すると、トークンのコストがトークンの種類ごとに分かれます。

すべてのレスポンスには data_refreshed_at のタイムスタンプが含まれます。この時刻より後の利用量は、欠けているか一部だけの状態です。

2026 年 10 月 29 日に、ベータとして提供が始まりました。利用には analytics-usage-cost-2026-08-24 ベータヘッダーが必要です。2 つのエンドポイントが報告する対象は、Claude Console と Claude Enterprise の組織のトークン利用量とコストです。対象プランや提供地域は、公式のリリースノートには記載がありません。

この API はベータとして提供されており、analytics-usage-cost-2026-08-24 ベータヘッダーを使って利用します。

1. すべてのリクエストに anthropic-beta: analytics-usage-cost-2026-08-24 ヘッダーと anthropic-version ヘッダーを付けて送ります。
2. ドキュメントのコード例は環境変数 ANTHROPIC_API_KEY からキーを読み込みます。例を実行する前に、この環境変数にキーを設定します。