차원별 토큰 사용량 조회
GET/v1/organizations/analytics/usage
Requires
anthropic-beta: analytics-usage-cost-2026-08-24. How to send beta headers날짜 범위에 걸친 토큰 사용량을 차원별로 나누어 조회합니다.
범위 내에 사용량이 있는 요청된 group_by[] 차원(및 time_bucket_width가 설정된 경우 시간 버킷)의 조합당 하나의 행을 반환하며, order_by 지표에 따라 순위가 매겨지거나 시간 버킷 순으로 정렬됩니다. 모든 조합은 여러 페이지에 걸쳐 반환됩니다. group_by[]와 time_bucket_width가 모두 없으면 단일 행이 전체 범위를 집계합니다. 시트 사용자에게 귀속되는지 여부와 관계없이 모든 사용량이 포함됩니다. read:analytics 범위가 있는 API 키 또는 Admin API 키가 필요합니다.
Parameters
Returns
차원별 토큰 사용량 조회
using System;
using Anthropic.Models.Beta.Organization.Analytics.Usage;
UsageListParams parameters = new()
{
StartingAt = DateTimeOffset.Parse("2026-09-01T00:00:00Z")
};
var page = await client.Beta.Organization.Analytics.Usage.List(parameters);
await foreach (var item in page.Paginate())
{
Console.WriteLine(item);
}Response 200
{
"data": [
{
"ending_at": "2026-10-01T00:00:00Z",
"group": {
"actor": {
"deleted": false,
"email_address": "user@emaildomain.com",
"name": "Jane Doe",
"type": "user_actor",
"user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
},
"actor_type": "user_actor",
"agent_id": "agent_01VHd3EAGJ6PLkP9LM7DDu3f",
"api_key_id": "apikey_01Rj2N8SVvo6BePZj99NhmiT",
"claude_tag_category": "dm",
"claude_tag_user_id": "U0123ABCDEF",
"context_window": "0-200k",
"deployment_id": "depl_01JFC6ihzZHtAuyHsaENdJhY",
"environment_id": "env_017oTjuGedHtjhJauVC5xGJD",
"inference_geo": "global",
"model": "claude-opus-5-5",
"product": "chat",
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"service_tier": "standard",
"session_id": "sesn_0187kPDyNCwibNNvfaPEApCJ",
"slack_channel_id": "C0123ABCDEF",
"speed": "fast",
"user_profile_id": "uprof_01M33NeYUQK2WV9PpYcsPHLi",
"workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
},
"starting_at": "2026-09-01T00:00:00Z",
"usage": {
"cache_creation": {
"ephemeral_1h_input_tokens": 0,
"ephemeral_5m_input_tokens": 0
},
"cache_read_input_tokens": 3200000,
"output_tokens": 891000,
"requests": 128,
"server_tool_use": {
"web_search_requests": 10
},
"total_tokens": 5375500,
"uncached_input_tokens": 1284500
}
}
],
"data_refreshed_at": "2026-10-01T04:02:11Z",
"has_more": true,
"next_page": "next_page"
}Returns Examples
Response 200
{
"data": [
{
"ending_at": "2026-10-01T00:00:00Z",
"group": {
"actor": {
"deleted": false,
"email_address": "user@emaildomain.com",
"name": "Jane Doe",
"type": "user_actor",
"user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
},
"actor_type": "user_actor",
"agent_id": "agent_01VHd3EAGJ6PLkP9LM7DDu3f",
"api_key_id": "apikey_01Rj2N8SVvo6BePZj99NhmiT",
"claude_tag_category": "dm",
"claude_tag_user_id": "U0123ABCDEF",
"context_window": "0-200k",
"deployment_id": "depl_01JFC6ihzZHtAuyHsaENdJhY",
"environment_id": "env_017oTjuGedHtjhJauVC5xGJD",
"inference_geo": "global",
"model": "claude-opus-5-5",
"product": "chat",
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"service_tier": "standard",
"session_id": "sesn_0187kPDyNCwibNNvfaPEApCJ",
"slack_channel_id": "C0123ABCDEF",
"speed": "fast",
"user_profile_id": "uprof_01M33NeYUQK2WV9PpYcsPHLi",
"workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
},
"starting_at": "2026-09-01T00:00:00Z",
"usage": {
"cache_creation": {
"ephemeral_1h_input_tokens": 0,
"ephemeral_5m_input_tokens": 0
},
"cache_read_input_tokens": 3200000,
"output_tokens": 891000,
"requests": 128,
"server_tool_use": {
"web_search_requests": 10
},
"total_tokens": 5375500,
"uncached_input_tokens": 1284500
}
}
],
"data_refreshed_at": "2026-10-01T04:02:11Z",
"has_more": true,
"next_page": "next_page"
}