Claude Enterprise Analytics API リファレンスガイド

概要

Claude Enterprise Analytics APIは、Enterprise組織内のClaudeサーフェス全体にわたるエンゲージメント、採用、使用状況、およびコストデータへのプログラマティックアクセスを組織に提供します。ユーザーアクティビティの内部ダッシュボードを構築する場合、プロジェクトの採用を追跡する場合、月次請求に対する支出を調整する場合、または支出制限を設定する場合など、このAPIは必要なメトリクスを提供します。

データ集約

すべてのデータは組織ごと、日ごとに集約されます。各エンドポイントは、指定した単一の日付のスナップショットを返します。日(N-1)のデータは日Nの10:00:00 UTC時刻に実行され、データの正確性を確保するため、集約から3日後にクエリ可能になります。

上記のタイムライン内でデータが利用できない場合、これは通常、当社のチームが内部で調査する必要があるデータパイプラインの障害を示しています。通常、このような問題は認識していますが、確認が必要な場合や他の問題が疑われる場合は、CSMに報告してください。

コストと使用状況のエンドポイントは異なる鮮度モデルを持っています。詳細については、以下のコストと使用状況のエンドポイントを参照してください。

アクセスの有効化

新しい分析APIキーを生成するには、Enterprise組織内のプライマリオーナーである必要があります。claude.ai/analytics/api-keysに移動することで実行できます。

役に立つかもしれない詳細情報：

いつでもパブリックAPIへのアクセスを有効/無効にできます。スイッチをオフにしてアクセスを無効にすると、すべてのリクエストが拒否されます。
APIにアクセスするには、read:analyticsスコープを持つキーが必要です。組織用に複数のキーを作成できますが、レート制限はキーレベルではなく組織レベルで適用されます。以下の「レート制限」セクションを参照してください。
いつものように、APIキーを安全に処理することを強くお勧めします：これらのキーを公開で共有しないでください。これらはシークレットであり、安全に共有する必要があります。

ベースURL

すべてのリクエストは以下に送信されます：

https://api.anthropic.com/v1/organizations/analytics/

認証

すべてのリクエストには、x-api-keyヘッダーで渡されるAPIキーが必要です。APIキーはread:analyticsスコープを持つ必要があります。APIキーはclaude.aiの管理設定のAPIキーセクションから作成および管理できます。

リクエストヘッダーの例：

x-api-key: $YOUR_API_KEY

ページネーション

複数のエンドポイントはページネーション結果を返します。ページネーションはカーソルベースのアプローチを使用し、レスポンスには次のリクエストで渡すnext_pageトークンが含まれ、結果の次のページを取得します。

2つのオプションパラメータがページネーションを制御します：

limit（整数）：ページあたりのレコード数。/usersエンドポイントのデフォルトは20、他のすべてのエンドポイントのデフォルトは100です。コストと使用状況のエンドポイントの場合、デフォルトはエンドポイントとバケット幅によって異なります。詳細については、以下のコストと使用状況のエンドポイントを参照してください。最大値は1000です。

page（文字列）：前のレスポンスのnext_pageフィールドからの不透明なカーソルトークン。最初のリクエストではこれを省略してください。

結果がなくなると、レスポンスのnext_pageはnullになります。

重要：コストと使用状況のエンドポイントでシーケンス中にクエリパラメータを変更しないでください。カーソルは、それらを発行したフィルタと日付範囲にバインドされています。products[]、order_by、group_by[]、日付範囲、またはその他のフィルタを変更して古いカーソルを渡すと、400エラーが発生します。

エラーレスポンス

すべてのエンドポイントは標準HTTPエラーコードを返します：

コード	意味
400	クエリパラメータが無効です。一般的な原因には、無効な日付、1/1/26より前の日付（最初の利用可能日）、今日または将来の日付、または（コストと使用状況のエンドポイント上の）現在のクエリパラメータと一致しないページカーソルが含まれます。
401	APIキーが見つからないか無効です（コストと使用状況のエンドポイント）。
404	APIキーが見つからない、無効である、または`read:analytics`スコープを持っていません。
410	ページカーソルは有効ではなくなりました。最初のページからページネーションを再開してください。
429	レート制限を超過しました。リクエストが多すぎます。
500	内部エラー（コストと使用状況のエンドポイント）。
504	リクエストがタイムアウトしました。

レート制限

このAPI内のすべてのエンドポイントに適用されるデフォルトレート制限があります。ユースケースに十分でない場合は、その理由を理解したいと思います。必要に応じて、組織のレート制限を調整できます。CSMに連絡してください。

エンゲージメントと採用のエンドポイント

1. ユーザーアクティビティをリスト表示

GET /v1/organizations/analytics/users

単一の日のユーザーごとのエンゲージメントメトリクスを返します。レスポンス内の各項目は1人のユーザーを表し、Claude（チャット）とClaude Code全体のアクティビティカウントを含みます。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	文字列	はい	メトリクスを取得する日付（YYYY-MM-DD形式）。
`limit`	整数	いいえ	ページあたりのレコード数（デフォルト：20、最大：1000）。
`page`	文字列	いいえ	前のレスポンスの`next_page`フィールドのカーソルトークン（次のページを取得するため）。

レスポンスフィールド（ユーザーごと）

フィールド	説明
`user.id`	ユーザーの一意の識別子。
`user.email_address`	ユーザーのメールアドレス。
`chat_metrics.distinct_conversation_count`	個別の会話数（Claude.ai内）。
`chat_metrics.message_count`	送信されたメッセージの総数（Claude.ai内）。
`chat_metrics.distinct_projects_created_count`	作成された個別プロジェクト数（Claude.ai内）。
`chat_metrics.distinct_projects_used_count`	使用された個別プロジェクト数（Claude.ai内）。
`chat_metrics.distinct_files_uploaded_count`	アップロードされた個別ファイル数（Claude.ai内）。
`chat_metrics.distinct_artifacts_created_count`	作成された個別アーティファクト数（Claude.ai内）。
`chat_metrics.distinct_shared_artifacts_viewed_count`	表示された共有アーティファクト数（Claude.ai内）。
`chat_metrics.thinking_message_count`	思考（拡張）メッセージ数（Claude.ai内）。
`chat_metrics.distinct_skills_used_count`	使用された個別スキル数（Claude.ai内）。
`chat_metrics.connectors_used_count`	呼び出されたコネクタの総数（Claude.ai内）。
`chat_metrics.shared_conversations_viewed_count`	表示された共有会話数（Claude.ai内）。
`claude_code_metrics.core_metrics.commit_count`	Claude Codeを通じて行われたgitコミット数。
`claude_code_metrics.core_metrics.pull_request_count`	Claude Codeを通じて作成されたプルリクエスト数。
`claude_code_metrics.core_metrics.lines_of_code.added_count`	追加されたコード行の合計。
`claude_code_metrics.core_metrics.lines_of_code.removed_count`	削除されたコード行の合計。
`claude_code_metrics.core_metrics.distinct_session_count`	個別のClaudeコードセッション数。
`claude_code_metrics.tool_actions.edit_tool`	編集ツールの承認および却下カウント。
`claude_code_metrics.tool_actions.multi_edit_tool`	マルチ編集ツールの承認および却下カウント。
`claude_code_metrics.tool_actions.write_tool`	書き込みツールの承認および却下カウント。
`claude_code_metrics.tool_actions.notebook_edit_tool`	ノートブック編集ツールの承認および却下カウント。
`web_search_count`	ウェブ検索ツール呼び出しの合計。これはclaude.aiとあなたの組織内のClaudeコード使用の両方に適用されます。

Officeエージェントメトリクス（ユーザーあたり）

各ユーザーレコードには、ExcelおよびPowerPointの製品別内訳を含むoffice_metricsオブジェクトも含まれます。このブロックはすべてのレコードに常に存在します。Office Agent使用がない組織では、nullではなくすべてゼロ値が表示されます。

office_metricsオブジェクトには、excelとpowerpointの2つのキーが含まれます。

各キーには同じ6つのフィールドが含まれます。

フィールド	説明
`office_metrics.[product].distinct_session_count*`	個別のOfficeエージェントセッション数。
`office_metrics.[product].message_count`	送信されたメッセージ数（完了したエージェントターンごとに1つ）。
`office_metrics.[product].skills_used_count`	スキル呼び出しの合計。1つのスキルが5回使用された場合は5としてカウントされます。
`office_metrics.[product].distinct_skills_used_count`	使用された個別スキルの数。
`office_metrics.[product].connectors_used_count`	コネクタ呼び出しの合計。1つのコネクタが3回使用された場合は3としてカウントされます。
`office_metrics.[product].distinct_connectors_used_count`	使用された個別コネクタの数。

*注： [product]はexcelまたはpowerpointのいずれかです。

Claude Coworkメトリクス（ユーザーあたり）

各ユーザーレコードには、ユーザーごとのCoworkエンゲージメントを含むcowork_metricsオブジェクトも含まれます。このブロックはすべてのレコードに常に存在します。Cowork使用がない組織では、nullではなくすべてゼロ値が表示されます。

フィールド	説明
`cowork_metrics.distinct_session_count`	個別のCoworkセッション数。
`cowork_metrics.message_count`	Coworkで送信されたユーザーメッセージの合計。
`cowork_metrics.action_count`	成功したツール呼び出し（Bash、Read、Editなど）。
`cowork_metrics.dispatch_turn_count`	Dispatch（バックグラウンドエージェント）セッションで完了したエージェントターン。
`cowork_metrics.skills_used_count`	スキル呼び出しの合計。1つのスキルが5回使用された場合は5としてカウントされます。
`cowork_metrics.distinct_skills_used_count`	使用された異なるスキルの数。
`cowork_metrics.connectors_used_count`	コネクタの総呼び出し数。1つのコネクタが3回使用された場合は3としてカウントされます。
`cowork_metrics.distinct_connectors_used_count`	使用された異なるコネクタの数。

リクエスト例

curl -X GET "https://api.anthropic.com/v1/organizations/analytics/users?date=2025-01-01&limit=3"
   --header "x-api-key: $YOUR_API_KEY"

2. アクティビティサマリー

GET /v1/organizations/analytics/summaries

指定された日付範囲内の組織のエンゲージメントとシート利用率の日次の高レベルサマリーを返します。レスポンスは、日付範囲内の集計カウントを含む日のリストです。ending_dateとstarting_dateの最大差は31日である必要があり、データの利用可能性には3日間の遅延があります。これは日次アクティブユーザー、週次および月次トレンド、シート割り当てを一目で追跡するのに役立ちます。

「アクティブ」の定義以下のいずれかが当てはまる場合：

ユーザーがClaudeのチャット（chat）で少なくとも1つのチャットメッセージを送信した。
ユーザーがC4E組織に関連付けられたClaudeコード（ローカルまたはリモート）セッションを少なくとも1つ持ち、ツール使用/gitアクティビティがあった。
ユーザーがツール使用またはメッセージアクティビティを伴うClaudeCoworkセッションを少なくとも1つ持っていた。

クエリパラメータ

フィールド	タイプ	必須	説明
`starting_date`	文字列	はい	データを取得する開始日（YYYY-MM-DD形式）。データの利用可能性には3日間の遅延があるため、アクセスできる最新データは3日前のものです。
`ending_date`	文字列	いいえ	データを取得するオプションの終了日（YYYY-MM-DD形式）。これは排他的です。

レスポンスフィールド

フィールド	説明
`starting_date`	メトリクスが集計される最初の日（UTC日付として解釈）。データの利用可能性には3日間の遅延があるため、アクセスできる最新データは3日前のものです。
`ending_date`	メトリクスが集計される最後の日（排他的、UTC日付として解釈）
`daily_active_user_count`	指定された日付にアクティブなユーザー数（トークン消費に基づく）。
`weekly_active_user_count`	指定された日付で終了する7日間のローリングウィンドウ内でアクティブなユーザー数。
`monthly_active_user_count`	指定された日付で終了する30日間のローリングウィンドウ内でアクティブなユーザー数。
`assigned_seat_count`	組織内で現在割り当てられているシートの総数。
`pending_invite_count`	まだ受け入れられていない保留中の招待の数。
`cowork_daily_active_user_count`	その日に≥1つのCoworkセッションを持つユーザー数
`cowork_weekly_active_user_count`	ローリング7日間で≥1つのCoworkセッションを持つユーザー数。
`cowork_monthly_active_user_count`	ローリング30日間で≥1つのCoworkセッションを持つユーザー数。

注: 週次および月次カウントのローリングウィンドウは、指定された日付から遡ります（その日を含む）。ウィンドウ内の一部の日のデータが不完全な場合（たとえば、日付が過去30日未満の場合）、月次カウントはアクティビティを過小計上する可能性があります。

リクエスト例

curl -X GET "https://api.anthropic.com/v1/organizations/analytics/summaries?starting_date=2025-01-01"
   --header "x-api-key: $YOUR_API_KEY"

3. チャットプロジェクトの使用状況

GET /v1/organizations/analytics/apps/chat/projects

指定された日付のチャットプロジェクト別の使用データを返します。プロジェクトはClaude（チャット）に固有のため、このエンドポイントはそのサーフェスに焦点を当てています。各項目はプロジェクト名、それと対話したユニークユーザー数、およびそのプロジェクトで行われた会話の総数を表示します。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	文字列	はい	メトリクスを取得する日付。YYYY-MM-DD形式です。データの可用性には3日間の遅延があるため、アクセスできる最新データは3日前のものです。
`limit`	整数	いいえ	ページあたりのレコード数（デフォルト：100、最大：1000）。
`page`	文字列	いいえ	前のレスポンスの`next_page`フィールドからのカーソルトークン。次のページを取得するために使用します。

レスポンスフィールド（プロジェクトごと）

フィールド	説明
`project_name`	プロジェクトの名前。
`project_id`	タグ付きプロジェクトID。例：「claude_proj_{ID}」
`distinct_user_count`	指定された日付にこのプロジェクトを使用したユニークユーザー数。
`distinct_conversation_count`	指定された日付にこのプロジェクト内の会話数。
`message_count`	指定された日付にこのプロジェクト内で送信されたメッセージの総数。
`created_at`	プロジェクト作成のタイムスタンプ。
`created_by`	プロジェクトを作成したユーザーの`{id, email_address}`。

リクエスト例

curl -X GET "https://api.anthropic.com/v1/organizations/analytics/apps/chat/projects?date=2025-01-01&limit=50"
   --header "x-api-key: $YOUR_API_KEY"

4. スキル使用状況

GET /v1/organizations/analytics/skills

指定された日付について、組織全体のClaude（チャット）とClaude Code両方のスキル使用データを返します。各項目はスキルを表し、それを使用したユニークユーザー数を表示します。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	文字列	はい	メトリクスを取得する日付（YYYY-MM-DD形式）。データの利用可能性には3日間の遅延があるため、アクセスできる最新のデータは3日前のものです。
`limit`	整数	いいえ	ページあたりのレコード数（デフォルト：100、最大：1000）。
`page`	文字列	いいえ	前のレスポンスの`next_page`フィールドのカーソルトークン（次のページを取得するため）。

レスポンスフィールド（スキルごと）

フィールド	説明
`skill_name`	スキルの名前。
`distinct_user_count`	指定された日付にこのスキルを使用した一意のユーザー数。
`chat_metrics.distinct_conversation_skill_used_count`	チャットでスキルが少なくとも1回使用された個別の会話数。
`claude_code_metrics.distinct_session_skill_used_count`	Claude Codeでスキルが少なくとも1回使用された個別のリモートセッション数。

Office Agentメトリクス（スキルごと）

各スキルレコードには、Office Agentセッションがスキルを使用した数を製品別に報告するoffice_metricsオブジェクトも含まれます。このブロックは常に存在します。Office Agent使用がない組織では、すべてのゼロ値が表示されます。

フィールド	説明
`office_metrics.excel.distinct_session_skill_used_count`	ExcelのOffice Agentセッションでこのスキルが使用された個別セッション数。
`office_metrics.powerpoint.distinct_session_skill_used_count`	PowerPointのOffice Agentセッションでこのスキルが使用された個別セッション数。

Claude Coworkメトリクス（スキルごと）

各スキルレコードには、Coworkセッションがスキルを使用した数を報告するcowork_metricsオブジェクトも含まれます。このブロックは常に存在します。Cowork使用がない組織では、すべてのゼロ値が表示されます。

cowork_metrics.distinct_session_skill_used_count

このスキルが少なくとも1回使用された個別のCoworkセッション数。

リクエスト例

curl -X GET "https://api.anthropic.com/v1/organizations/analytics/skills?date=2025-01-01"
   --header "x-api-key: $YOUR_API_KEY"

5. コネクタ使用状況

GET /v1/organizations/analytics/connectors

指定された日付について、組織内のClaude（チャット）とClaude Code両方にわたるMCP/コネクタ使用データを返します。各項目はコネクタを表し、それを使用した一意のユーザー数を示します。コネクタ名はさまざまなソースから正規化されます。たとえば、「Atlassian MCP server」、「mcp-atlassian」、「atlassian_MCP」はすべて「atlassian」として表示されます。

クエリパラメータ

フィールド	タイプ	必須	説明
`date`	文字列	はい	メトリクスを取得する日付（YYYY-MM-DD形式）。データの利用可能性には3日間の遅延があるため、アクセスできる最新のデータは3日前のものです。
`limit`	整数	いいえ	ページあたりのレコード数（デフォルト：100、最大：1000）。
`page`	文字列	いいえ	前のレスポンスの`next_page`フィールドからのカーソルトークン。次のページを取得するために使用します。

レスポンスフィールド（コネクタごと）

フィールド	説明
`connector_name`	コネクタの正規化された名前。
`distinct_user_count`	指定された日付にこのコネクタを使用した一意のユーザー数。
`chat_metrics.distinct_conversation_connector_used_count`	チャットでコネクタが少なくとも1回使用された個別の会話数。
`claude_code_metrics.distinct_session_connector_used_count`	Claude Codeでコネクタが少なくとも1回使用された個別のリモートセッション数。

Office Agentメトリクス（コネクタごと）

各コネクタレコードには、Office Agentセッションがコネクタを使用した数を製品別に報告するoffice_metricsオブジェクトも含まれます。このブロックは常に存在します。Office Agent使用がない組織では、すべてのゼロ値が表示されます。

フィールド	説明
`office_metrics.excel.distinct_session_connector_used_count`	このコネクタが使用されたExcelのOffice Agentセッションの個別数。
`office_metrics.powerpoint.distinct_session_connector_used_count`	このコネクタが使用されたPowerPointのOffice Agentセッションの個別数。

Claude Coworkメトリクス（コネクタごと）

各コネクタレコードには、Coworkセッションがコネクタを使用した数を報告するcowork_metricsオブジェクトも含まれます。このブロックは常に存在します。Cowork使用がない組織では、すべてのゼロ値が表示されます。

フィールド	説明
`cowork_metrics.distinct_session_connector_used_count`	このコネクタが少なくとも1回使用された個別のCoworkセッション数。

リクエスト例

curl -X GET "https://api.anthropic.com/v1/organizations/analytics/connectors?date=2025-01-01"
   --header "x-api-key: $YOUR_API_KEY"

コストと使用状況エンドポイント

注：コストと使用状況エンドポイントは、使用量ベースのエンタープライズプランに適用されます。シートベースのエンタープライズプランの場合、これらのエンドポイントは使用クレジットのみを反映します。

コストと使用状況エンドポイント（現在ベータ版で利用可能）は、Claude（チャット）、Claude Code、Cowork、Office Agent、およびChrome内のClaudeのトークンとUSDコストデータへのプログラムによるアクセスを組織に提供します。

2つの形式で4つのエンドポイントがあります：

形式	エンドポイント	戻り値
ユーザーごと（ユーザーごとに1行、ソート済み）	user_usage_report、user_cost_report	日付範囲全体でトークンまたは支出でランク付けされたユーザー。
バケット化（時間バケットごとに1行、オプションでグループ化）	usage_report、cost_report	時間経過に伴う使用状況またはコスト。製品、モデル、またはその他の次元別に分類されます。

ユーザーごとエンドポイントを使用して「トップスペンダーは誰か？」に答えます。バケット化エンドポイントを使用して「使用状況は日ごとにどのようにトレンドしているか、製品別に分類されているか？」に答えます。

データの鮮度と最終性

データは通常、基礎となる使用状況の4時間以内に利用可能ですが、最大24時間かかる場合があります。各レスポンスには、レスポンスが提供されたエクスポートを示すdata_refreshed_atタイムスタンプが含まれます。そのウォーターマーク後に発生した使用状況はまだ反映されていません。

特定の日付の値は、遅延イベントが到着し、調整実行が行われるため、最大30日間改訂される可能性があります。請求書グレードの合計については、少なくとも30日前の日付をクエリしてください。

ending_atが省略されている場合（デフォルトは「now」）、レスポンスにはdata_refreshed_at後の不完全なデータのテールが含まれます。繰り返されるコールで安定した結果を得るには、ending_atを以前に返されたdata_refreshed_at以前の値に設定します。

日付範囲の制限

starting_atは過去365日まで遡ることができ、単一のクエリは最大31日（ending_at - starting_at）にまたがることができます。より長い期間をカバーするには、隣接するウィンドウで複数のクエリを発行してください。2026-01-01より前のデータは利用できません。

ページネーション

4つのコストと使用状況エンドポイントはすべて、不透明なカーソルでページネーションされます。最初のリクエストはlimit行までと次のページカーソルを返します。そのカーソルを次のリクエストのページパラメータとして変更せずに渡し、has_moreがfalseになるまで繰り返します。

next_pageを不透明として扱う：次のリクエストで変更せずに返し、すべてのページで同じクエリパラメータを送信します。リクエストがページカーソルに関するメッセージで400または410を返す場合は、それを破棄して最初のページから再度開始します。

シーケンスの途中でクエリパラメータを変更しないでください。カーソルは、それらを発行したフィルタと日付範囲にバインドされています。products[]、order_by、group_by[]、日付範囲、またはその他のフィルタを変更して古いカーソルを渡すと、400エラーが発生します。

リストパラメータのシリアル化

リストパラメータはブラケット記法を使用します：各値に対してパラメータ名を[]で繰り返します。

products[]=chat&products[]=claude_code

Actorオブジェクト

ユーザーごとの結果行は、使用状況を生成したユーザーを識別します。

{
  "type": "user_actor",
  "user_id": "user_01AbCdEfGh",
  "name": "Jane Smith",
  "email": "[email protected]"
}

フィールド	タイプ	説明
type	string	常に「user_actor」です。
user_id	string	ユーザーのID。user_ids[]で受け入れられる同じ値。
name	string or null	ユーザーの名前。ユーザーが削除された場合は「削除されたユーザー」。
email	string or null	ユーザーのメールアドレス。ユーザーが削除された場合はNull。
deleted	boolean	アカウントが削除されている場合はTrue。

6. ユーザーごとのトークン使用状況

GET /v1/organizations/analytics/user_usage_report

日付範囲全体のユーザーごとのトークン使用状況を返します。選択したトークンメトリックでソートされます。

クエリパラメータ

フィールド	タイプ	必須	デフォルト	説明
starting_at	RFC 3339 datetime	はい	—	範囲の開始（包括的）。UTC時間の開始時刻に切り下げられます。過去365日以内である必要があります。
ending_at	RFC 3339 datetime	いいえ	now	範囲の終了（排他的）。範囲は最大31日間にわたることができます。
products[]	chat、claude_code、cowork、office_agent、claude_in_chrome、claude_designのいずれか1つ以上	いいえ	すべてのシートベースの製品	シートベースの製品サーフェスのみ。複数の値の場合はパラメータを繰り返します。
models[]	文字列、最大100エントリ	いいえ	すべて	特定のモデル名にフィルタリング（例：claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5-20251001）。
user_ids[]	文字列、最大100エントリ	いいえ	すべて	特定のユーザーにフィルタリング。組織全体をページネーションせずに既知のユーザーセットを検索する場合に便利です。
context_windows[]	0-200k、200k-1Mのいずれか1つ以上	いいえ	すべて	特定のコンテキストウィンドウ価格帯にフィルタリング。group_by[]=context_windowを使用して階層ごとの値を分割します。
inference_geos[]	global、us、not_availableのいずれか1つ以上	いいえ	すべて	特定の推論リージョンにフィルタリング。not_availableはリージョンが未設定の行にマッチします。group_by[]=inference_geoを使用してリージョンごとの値を分割します。
speeds[]	fast、standardのいずれか1つ以上	いいえ	すべて	高速または標準推論モードにフィルタリング。group_by[]=speedを使用してモードごとの値を分割します。
group_by[]	product、model、context_window、inference_geo、speedのいずれか1つ以上	いいえ	なし	各ユーザーの行を指定されたディメンションで分割します。ディメンションが存在する場合、1人のユーザーが複数の行にまたがる可能性があります。
order_by	total_tokens、output_tokens、uncached_input_tokens	いいえ	total_tokens	ソート対象のメトリック。
exclude_deleted_users	ブール値	いいえ	false	trueの場合、削除されたユーザーの行は除外されます。
order	desc、asc	いいえ	desc	ソート方向。
limit	整数1～1000	いいえ	20	ページあたりの行数。
ページ	不透明なカーソル文字列	いいえ	—	前のレスポンスからのnext_page値。

レスポンスフィールド

フィールド	説明
organization_id	APIキーが属する組織のID。
data	エントリの配列。order_byで指定された順序で並べ替えられています。
data[].actor	使用量を生成したユーザーのActorオブジェクト。
data[].product	group_by[]に製品が含まれる場合は製品サーフェス。それ以外はnull。
data[].model	group_by[]にモデルが含まれる場合はモデル名。それ以外はnull。
data[].context_window	group_by[]にcontext_windowが含まれる場合はコンテキストティア（0-200kまたは200k-1M）。それ以外はnull。
data[].inference_geo	group_by[]にinference_geoが含まれる場合は推論リージョン。それ以外はnull。
data[].speed	group_by[]にspeedが含まれる場合：fastまたはstandard。それ以外はnull。
data[].uncached_input_tokens	プロンプトキャッシュから提供されなかった入力トークン。
data[].cache_creation.ephemeral_5m_input_tokens	5分間のプロンプトキャッシュに書き込まれたトークン。
data[].cache_creation.ephemeral_1h_input_tokens	1時間のプロンプトキャッシュに書き込まれたトークン。
data[].cache_read_input_tokens	プロンプトキャッシュから提供された入力トークン。
data[].output_tokens	生成された出力トークン。
data[].total_tokens	上記のすべてのトークンコンポーネントの合計。デフォルトのorder_by=total_tokensはこの値でソートされます。
data[].server_tool_use.web_search_requests	ウェブ検索ツール呼び出しの数。
data[].requests	APIリクエストの数
has_more	別のページが存在するかどうか。
next_page	次のページの不透明なカーソル。has_moreがfalseの場合はnull。
data_refreshed_at	このレスポンスが提供されたデータエクスポートのタイムスタンプ。

リクエスト例

curl "https://api.anthropic.com/v1/organizations/analytics/user_usage_report?starting_at=2026-03-01T00:00:00Z&products[]=claude_code&order_by=output_tokens&limit=20" \

--header "x-api-key: $YOUR_API_KEY"

7. ユーザーごとのコスト

GET /v1/organizations/analytics/user_cost_report

日付範囲全体のユーザーごとのUSDコストを返します。割引価格またはリスト価格の金額でソートされます。

クエリパラメータ

user_usage_reportと同じですが、以下の違いがあります：

フィールド	タイプ	必須	デフォルト	説明
order_by	amount、list_amount	いいえ	amount	ソート対象のメトリック。
group_by[]	product、model、context_window、inference_geo、speed、cost_type、token_typeのいずれか1つ以上	いいえ	なし	各ユーザーの行を指定されたディメンションで分割します。cost_typeはコストコンポーネント（トークン、ウェブ検索、コード実行）ごとに1行を返します。token_typeはトークンタイプごとに1行を返します。

その他すべてのパラメータ（starting_at、ending_at、products[]、models[]、user_ids[]、order、limit、page）は同じです。

レスポンスフィールド

フィールド	説明
organization_id	APIキーが属する組織のID。
data	order_byでソートされたエントリの配列（ソート方向に従う）。
data[].actor	コストを生成したユーザーのActorオブジェクト。
data[].product、data[].model、data[].context_window、data[].inference_geo、data[].speed	対応するgroup_by[]値が設定されている場合、ディメンション値。それ以外の場合はnull。
data[].currency	常に「USD」。
data[].amount	小数セント単位の金額 — 交渉済み割引後の実際の消費コスト。例えば、「41280.000000」は$412.80です。この値はproducts[]フィルタ内のすべての製品にわたって合計されます。
data[].list_amount	定価（割引前）の小数セント単位の金額（同じ形式）。
data[].cost_type	group_by[]にcost_typeが含まれる場合：tokens、web_search、code_executionのいずれか。設定されていない場合はnull。
data[].token_type	group_by[]にtoken_typeが含まれる場合：uncached_input_tokens、output_tokens、cache_read_input_tokens、cache_creation.ephemeral_5m_input_tokens、cache_creation.ephemeral_1h_input_tokensのいずれか。cost_typeがtokensの行でのみnull以外。
data[].requests	APIリクエスト数
has_more	別のページが存在するかどうか。
next_page	次のページの不透明なカーソル。
data_refreshed_at	このレスポンスが提供されたデータエクスポートのタイムスタンプ。

金額の解析

amountとlist_amountはセント単位の10進数文字列です。「41280.000000」は41,280セント（米国$412.80）を表します。ドルに変換するには、10進数として解析して100で割ります。数百万ドルを超える可能性のある値については、バイナリ浮動小数点解析を避けてください。

リクエスト例

curl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-03-01T00:00:00Z&order_by=amount&limit=20" \

--header "x-api-key: $YOUR_API_KEY"

8. 時間経過に伴うトークン使用量

GET /v1/organizations/analytics/usage_report

時間経過に伴うトークン使用量を返します。分、時間、または日単位でバケット化され、オプションで製品、モデル、コンテキストウィンドウ、推論リージョン、または速度別に分類されます。

クエリパラメータ

フィールド	タイプ	必須	デフォルト	説明
starting_at	RFC 3339 datetime	はい	—	範囲の開始（含む）。過去365日以内である必要があります。UTC内の最も近いbucket_width境界に切り下げられます。
ending_at	RFC 3339 datetime	いいえ	now	範囲の終了（除く）。範囲は最大31日間にわたることができます。UTC内の最も近いbucket_width境界に切り下げられます。
bucket_width	1m, 1h, 1d	いいえ	1d	時間バケットの粒度：分、時間、または日。
group_by[]	product、model、context_window、inference_geo、speedのいずれか1つ以上	いいえ	none	各バケット内で分類するディメンション。単一の集計をバケットごとに取得する場合は省略します。
products[]	chat、claude_code、cowork、office_agent、claude_in_chrome、claude_designのいずれか1つ以上	いいえ	all	特定の製品サーフェスにフィルタリングします。
models[]	文字列、最大100エントリ	いいえ	all	特定のモデル名にフィルタリングします。
context_windows[]	0-200k、200k-1Mのいずれか1つ以上	いいえ	all	特定のコンテキストウィンドウ価格帯にフィルタリングします。group_by[]=context_windowを使用して、階層ごとの値を分類します。
inference_geos[]	global、us、not_availableのいずれか1つ以上	いいえ	all	特定の推論リージョンにフィルタリングします。not_availableは、リージョンが設定されていない行と一致します。group_by[]=inference_geoを使用して、リージョンごとの値を分類します。
speeds[]	高速または標準のいずれか1つ以上	いいえ	すべて	高速または標準推論モードにフィルタリングします。
user_ids[]	文字列、最大100エントリ	いいえ	すべて	特定のユーザーにフィルタリングします。
limit	整数	いいえ	異なります	ページあたりのバケット数。デフォルトと最大値はbucket_widthによって異なります：1d → 7（最大31）；1h → 24（最大168）；1m → 60（最大256）。
page	不透明なカーソル文字列	いいえ	—	前のレスポンスのnext_page値。

レスポンスフィールド

フィールド	説明
organization_id	APIキーが属する組織のID。
data	エントリの配列、時間バケットごとに1つ。
data[].starting_at	バケット開始。
data[].ending_at	バケット終了。
data[].results	エントリの配列、バケット内のグループごとに1つ。group_by[]が省略されている場合、すべてのディメンションフィールドがnullの単一エントリ。
data[].results[].product、.model、.context_window、.inference_geo、.speed	対応するgroup_by[]値が設定されている場合、ディメンション値。それ以外の場合はnull。
data[].results[].uncached_input_tokens	プロンプトキャッシュから提供されなかった入力トークン。
data[].results[].cache_creation.ephemeral_5m_input_tokens	5分間のプロンプトキャッシュに書き込まれたトークン。
data[].results[].cache_creation.ephemeral_1h_input_tokens	1時間のプロンプトキャッシュに書き込まれたトークン。
data[].results[].cache_read_input_tokens	プロンプトキャッシュから提供された入力トークン。
data[].results[].output_tokens	生成された出力トークン。
data[].results[].server_tool_use.web_search_requests	ウェブ検索ツール呼び出しの数。
has_more	より多くのバケットが存在するかどうか。
next_page	次のページの不透明なカーソル。
data_refreshed_at	このレスポンスが提供されたデータエクスポートのタイムスタンプ。

リクエスト例

curl "https://api.anthropic.com/v1/organizations/analytics/usage_report?starting_at=2026-03-01T00:00:00Z&bucket_width=1d&group_by[]=product" \

--header "x-api-key: $YOUR_API_KEY"

9. 時間経過に伴うコスト

GET /v1/organizations/analytics/cost_report

USD コスト（時間経過）を返します。usage_report と同じ方法でバケット化およびグループ化されます。

クエリパラメータ

usage_report と同じ（bucket_width、group_by[]、filters、limit、page）。group_by[] 値はこのエンドポイントで cost_type と token_type も受け入れます。

レスポンスフィールド

フィールド	説明
organization_id	API キーが属する組織の ID。
data	エントリの配列。時間バケットごとに 1 つ。
data[].starting_at	バケット開始。
data[].ending_at	バケット終了。
data[].results	エントリの配列。バケット内のグループごとに 1 つ。
data[].results[].product、.model、.context_window、.inference_geo、.speed	対応する group_by[] 値が設定されている場合、ディメンション値。それ以外の場合は null。
data[].results[].cost_type	group_by[] に cost_type が含まれる場合：tokens、web_search、または code_execution。設定されていない場合は null。
data[].results[].token_type	group_by[] に token_type が含まれる場合：エンドポイント 7 に記載されているトークンタイプのいずれか。コストエンドポイントのみ — token_type は usage_report で拒否されます。
data[].results[].currency	"USD" です。
data[].results[].amount	小数セント単位の金額 — 交渉済み割引後の生コスト。
data[].results[].list_amount	定価（割引前）小数セント単位。
has_more	より多くのバケットが存在するかどうか。
next_page	次のページの不透明なカーソル。
data_refreshed_at	このレスポンスが提供されたデータエクスポートのタイムスタンプ。

リクエスト例

curl "https://api.anthropic.com/v1/organizations/analytics/cost_report?starting_at=2026-03-01T00:00:00Z&bucket_width=1d&group_by[]=model" \

--header "x-api-key: $YOUR_API_KEY"

Team プランと Enterprise プランで Claude Cowork を使用する

Claude Enterprise Analytics APIを始める

OpenTelemetryを使用してClaude Coworkアクティビティを監視する

Claude Cowork デスクトップアーキテクチャの概要

Claude Enterprise 利用ガイド