Usage

ディメンション別のトークン使用量を取得

UsageListPage Beta.Organization.Analytics.Usage.List(parameters, cancellationToken = default)

GET/v1/organizations/analytics/usage

Requires anthropic-beta: analytics-usage-cost-2026-08-24. How to send beta headers

指定した日付範囲におけるトークン使用量を、ディメンション別に分けて取得します。

Models

class BetaAnalyticsUsageGroup { Actor; ActorType; AgentID; /* 16 more */ }

The dimension values one usage row is broken out by; each is null unless its dimension is in group_by[].

enum BetaAnalyticsUsageGroupBy

class BetaAnalyticsUsageItem { EndingAt; Group; StartingAt; Usage; }

class BetaAnalyticsUsageMetrics { CacheCreation; CacheReadInputTokens; OutputTokens; /* 4 more */ }

The token usage of one row.

required BetaCacheCreation CacheCreation

The number of input tokens for cache creation.

required long Ephemeral1hInputTokens

The number of input tokens used to create the 1 hour cache entry.

minimum0

required long Ephemeral5mInputTokens

The number of input tokens used to create the 5 minute cache entry.

minimum0

required long CacheReadInputTokens

The number of input tokens read from the cache.

required long OutputTokens

The number of output tokens generated.

required long? Requests

Number of API requests in this row's scope. For sandbox / code-execution events, this counts execution spans rather than HTTP requests (these rows surface with product: null).

required BetaAnalyticsServerToolUse ServerToolUse

Server-side tool usage metrics.

required long WebSearchRequests

The number of web search requests made.

required long TotalTokens

Total token count across all token types. This is the value the default order_by (total_tokens) sorts on.

required long UncachedInputTokens

The number of uncached input tokens processed.

enum BetaAnalyticsUsageOrderBy

OutputTokens("output_tokens")

Requests("requests")

Time("time")

TotalTokens("total_tokens")

UncachedInputTokens("uncached_input_tokens")