Claude Platform Docs

Cost

Get Cost By Dimension
CostListPage Beta.Organization.Analytics.Cost.List(parameters, cancellationToken = default)
GET/v1/organizations/analytics/cost

Get cost in USD across a date range, broken out by dimension.

Models
class BetaAnalyticsCostGroup { Actor; ActorType; AgentID; /* 18 more */ }

The dimension values one cost row is broken out by, including cost_type and token_type.

enum BetaAnalyticsCostGroupBy
class BetaAnalyticsCostItem { Cost; EndingAt; Group; StartingAt; }
required BetaAnalyticsCostMetrics Cost

Cost for this row.

required string Amount

Amount (post-discount, pre-credit) in fractional cents (minor units).

required string Currency

Currency code for the cost amount. Currently always "USD".

required string ListAmount

List-price amount (pre-discount) in fractional cents.

required long? Requests

Number of API requests in this row's scope. Null when group_by includes cost_type or token_type (the count has no per-component attribution; read it from the ungrouped response). For sandbox / code-execution events, this counts execution spans rather than HTTP requests (these rows surface with product: null).

required DateTimeOffset EndingAt

End of the period this row covers (exclusive), as an RFC 3339 UTC timestamp: the end of the row's time bucket when a time-bucket width is set; otherwise the requested ending_at (or, when omitted, the earlier of now and starting_at plus 31 days) rounded down to the hour, because without a time bucket the report covers whole hours.

formatdate-time
required BetaAnalyticsCostGroup Group

The dimension values this row's cost is broken out by.

required DateTimeOffset StartingAt

Start of the period this row covers (inclusive), as an RFC 3339 UTC timestamp: the start of the row's time bucket when a time-bucket width is set, otherwise the requested starting_at rounded down to the hour.

formatdate-time
class BetaAnalyticsCostMetrics { Amount; Currency; ListAmount; Requests; }

The cost of one row.

required string Amount

Amount (post-discount, pre-credit) in fractional cents (minor units).

required string Currency

Currency code for the cost amount. Currently always "USD".

required string ListAmount

List-price amount (pre-discount) in fractional cents.

required long? Requests

Number of API requests in this row's scope. Null when group_by includes cost_type or token_type (the count has no per-component attribution; read it from the ungrouped response). For sandbox / code-execution events, this counts execution spans rather than HTTP requests (these rows surface with product: null).

enum BetaAnalyticsCostOrderBy
Amount("amount")
ListAmount("list_amount")
Time("time")