사용자별 토큰 사용량 조회
GET/v1/organizations/analytics/user_usage_report
[레거시] 날짜 범위에 걸친 사용자별 토큰 사용량을 조회합니다.
선택한 토큰 지표에 따라 순위가 매겨진 사용자별 사용량을 반환합니다. group_by[] 또는 bucket_width를 사용하면 한 사용자가 여러 행으로 나뉩니다. 이를 사용하여 어떤 사용자가 가장 많은 토큰을 소비하는지 확인하세요. 사용자 계정에 귀속된 사용량만 포함되므로, Code Review 사용량이나 Slack 채널의 Claude Tag 사용량처럼 사용자 계정이 없는 사용량은 제외됩니다. Claude Tag 일대일 다이렉트 메시지는 Claude 계정을 연결한 멤버에 한해 제품 claude-tag로 포함됩니다. Claude Enterprise 플랜을 사용하는 조직에서 사용할 수 있습니다. read:analytics 범위가 있는 API 키가 필요합니다.
이 엔드포인트는 레거시 Claude Enterprise 사용량 및 비용 보고서 중 하나입니다. 새 통합에는 대신 Usage and Cost Analytics API의 GET /v1/organizations/analytics/usage를 사용하세요. 기존 통합을 옮기려면 Claude Enterprise 사용량 및 비용 보고서에서 마이그레이션을 참조하세요.
Query parameters
Headers
Returns
사용자별 토큰 사용량 조회
curl https://api.anthropic.com/v1/organizations/analytics/user_usage_report \
-H 'anthropic-version: 2026-10-21' \
-H "Authorization: Bearer $ANTHROPIC_API_KEY"Response 200
{
"data": [
{
"actor": {
"deleted": true,
"email_address": "jane@example.com",
"name": "Jane Smith",
"type": "user_actor",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt"
},
"cache_creation": {
"ephemeral_1h_input_tokens": 0,
"ephemeral_5m_input_tokens": 0
},
"cache_read_input_tokens": 3200000,
"claude_tag_category": "dm",
"claude_tag_user_id": "U0123ABCDEF",
"context_window": "0-200k",
"ending_at": "2019-12-27T18:11:19.117Z",
"inference_geo": "global",
"model": "claude-opus-5-5",
"output_tokens": 891000,
"product": "chat",
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"requests": 128,
"server_tool_use": {
"web_search_requests": 10
},
"slack_channel_id": "C0123ABCDEF",
"speed": "fast",
"starting_at": "2019-12-27T18:11:19.117Z",
"total_tokens": 5377000,
"uncached_input_tokens": 1284500
}
],
"data_refreshed_at": "2019-12-27T18:11:19.117Z",
"has_more": true,
"next_page": "next_page",
"organization_id": "org_013FP9SaFPBg7Kw7fetjn6cF"
}Returns Examples
Response 200
{
"data": [
{
"actor": {
"deleted": true,
"email_address": "jane@example.com",
"name": "Jane Smith",
"type": "user_actor",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt"
},
"cache_creation": {
"ephemeral_1h_input_tokens": 0,
"ephemeral_5m_input_tokens": 0
},
"cache_read_input_tokens": 3200000,
"claude_tag_category": "dm",
"claude_tag_user_id": "U0123ABCDEF",
"context_window": "0-200k",
"ending_at": "2019-12-27T18:11:19.117Z",
"inference_geo": "global",
"model": "claude-opus-5-5",
"output_tokens": 891000,
"product": "chat",
"rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"requests": 128,
"server_tool_use": {
"web_search_requests": 10
},
"slack_channel_id": "C0123ABCDEF",
"speed": "fast",
"starting_at": "2019-12-27T18:11:19.117Z",
"total_tokens": 5377000,
"uncached_input_tokens": 1284500
}
],
"data_refreshed_at": "2019-12-27T18:11:19.117Z",
"has_more": true,
"next_page": "next_page",
"organization_id": "org_013FP9SaFPBg7Kw7fetjn6cF"
}