Obter uso de tokens por usuário
[Legado] Obtém o uso de tokens por usuário em um intervalo de datas.
Retorna o uso por usuário, classificado pela métrica de tokens escolhida; group_by[] ou bucket_width divide um usuário em várias linhas. Use isso para ver quais usuários consomem mais tokens. Apenas o uso atribuído a uma conta de usuário é incluído, portanto o uso sem conta de usuário, como o uso do Code Review e o uso do Claude Tag em canais do Slack, fica de fora. As mensagens diretas individuais do Claude Tag são incluídas, com o produto claude-tag, apenas para membros que conectaram uma conta Claude. Disponível para organizações em um plano Claude Enterprise. Requer uma chave de API com o escopo read:analytics.
Este endpoint é um dos relatórios de uso e custo legados do Claude Enterprise. Para novas integrações, use GET /v1/organizations/analytics/usage na API de Análise de Uso e Custo. Para migrar uma integração existente, consulte Migrar dos relatórios de uso e custo do 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"{
"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
{
"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"
}