title: Get Claude Code Usage Report url: https://platform.claude.com/docs/en/api/beta/organization/usage_report/retrieve_claude_code
Get Claude Code Usage Report
GET /v1/organizations/usage_report/claude_code
Retrieve daily aggregated usage metrics for Claude Code users. Enables organizations to analyze developer productivity and build custom dashboards.
Query parameters
-
starting_at: stringUTC date in YYYY-MM-DD format. Returns metrics for this single day only.
pattern: ^\d{4}-\d{2}-\d{2}$, format: date
-
limit: optional numberNumber of records per page (default: 20, max: 1000).
default: 20, maximum: 1000, minimum: 1
-
page: optional stringOpaque cursor token from previous response's
next_pagefield.
Returns
-
BetaClaudeCodeUsageReport object-
data: array of objectList of Claude Code usage records for the requested date.
-
actor: UserActor or APIActorThe user or API key that performed the Claude Code actions.
-
UserActor object-
type: "user_actor"Actor type. Always
"user_actor"for a user. -
email_address: stringEmail address of the user who performed Claude Code actions.
-
-
APIActor object-
type: "api_actor"Actor type. Always
"api_actor"for an API key. -
api_key_name: stringName of the API key used to perform Claude Code actions.
-
-
-
core_metrics: objectCore productivity metrics measuring Claude Code usage and impact.
-
commits_by_claude_code: numberNumber of git commits created through Claude Code's commit functionality.
-
lines_of_code: objectStatistics on code changes made through Claude Code.
-
added: numberTotal number of lines of code added across all files by Claude Code.
-
removed: numberTotal number of lines of code removed across all files by Claude Code.
-
-
num_sessions: numberNumber of distinct Claude Code sessions initiated by this actor.
-
pull_requests_by_claude_code: numberNumber of pull requests created through Claude Code's PR functionality.
-
-
customer_type: "api" or "subscription"Type of customer account (api for API customers, subscription for Pro/Team customers).
-
"api" -
"subscription"
-
-
date: stringUTC day the usage metrics cover, as an RFC 3339 timestamp at midnight UTC (for example
2025-08-08T00:00:00Z).format: date-time
-
is_remote: booleanWhether the usage came from remote Claude Code sessions, such as Claude Code on the web. Remote and local usage are reported as separate rows.
-
model_breakdown: array of objectToken usage and cost breakdown by AI model used.
-
estimated_cost: objectEstimated cost for using this model
-
amount: numberEstimated cost amount in minor currency units (e.g., cents for USD).
-
currency: stringCurrency code for the estimated cost (e.g., 'USD').
-
-
model: stringName of the AI model used for Claude Code interactions.
-
tokens: objectToken usage breakdown for this model
-
cache_creation: numberNumber of cache creation tokens consumed by this model.
-
cache_read: numberNumber of cache read tokens consumed by this model.
-
input: numberNumber of input tokens consumed by this model.
-
output: numberNumber of output tokens generated by this model.
-
-
-
organization_id: stringID of the organization that owns the Claude Code usage.
-
terminal_type: stringType of terminal or environment where Claude Code was used.
-
tool_actions: map[object]Breakdown of tool action acceptance and rejection rates by tool type.
-
accepted: numberNumber of tool action proposals that the user accepted.
-
rejected: numberNumber of tool action proposals that the user rejected.
-
-
subscription_type: optional "enterprise" or "team" or nullSubscription tier for subscription customers.
nullfor API customers.-
"enterprise" -
"team"
-
-
-
has_more: booleanTrue if there are more records available beyond the current page.
-
next_page: string or nullOpaque cursor token for fetching the next page of results, or null if no more pages are available.
-
Example
curl https://api.anthropic.com/v1/organizations/usage_report/claude_code \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"Response (200)
{
"data": [
{
"actor": {
"email_address": "user@emaildomain.com",
"type": "user_actor"
},
"core_metrics": {
"commits_by_claude_code": 8,
"lines_of_code": {
"added": 342,
"removed": 128
},
"num_sessions": 15,
"pull_requests_by_claude_code": 2
},
"customer_type": "api",
"date": "2025-08-08T00:00:00Z",
"is_remote": false,
"model_breakdown": [
{
"estimated_cost": {
"amount": 186,
"currency": "USD"
},
"model": "claude-opus-5",
"tokens": {
"cache_creation": 2340,
"cache_read": 8790,
"input": 45230,
"output": 12450
}
},
{
"estimated_cost": {
"amount": 42,
"currency": "USD"
},
"model": "claude-sonnet-5",
"tokens": {
"cache_creation": 890,
"cache_read": 3420,
"input": 23100,
"output": 5680
}
}
],
"organization_id": "12345678-1234-5678-1234-567812345678",
"terminal_type": "iTerm.app",
"tool_actions": {
"edit_tool": {
"accepted": 25,
"rejected": 3
},
"multi_edit_tool": {
"accepted": 12,
"rejected": 1
},
"notebook_edit_tool": {
"accepted": 5,
"rejected": 2
},
"write_tool": {
"accepted": 8,
"rejected": 0
}
},
"subscription_type": "enterprise"
}
],
"has_more": true,
"next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}