Sign in

Get Claude Code Usage Report

Retrieve daily aggregated usage metrics for Claude Code users. Enables organizations to analyze developer productivity and build custom dashboards.

get/v1/organizations/usage_report/claude_code?beta=true

Query parameters

starting_atstring date required

UTC date in YYYY-MM-DD format. Returns metrics for this single day only.

Example:2026-07-01

UTC date in YYYY-MM-DD format. Returns metrics for this single day only.

limitinteger

Number of records per page (default: 20, max: 1000).

Number of records per page (default: 20, max: 1000).

pagestring nullable

Opaque cursor token from previous response's next_page field.

Opaque cursor token from previous response's next_page field.

Headers

x-api-keystring

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console.

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console.

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

has_moreboolean required

True if there are more records available beyond the current page.

next_pagestring nullable required

Opaque cursor token for fetching the next page of results, or null if no more pages are available.

Example response

{
  "data": [
    {
      "actor": {
        "email_address": "user@emaildomain.com"
      },
      "date": "2025-08-08T00:00:00Z",
      "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
        }
      }
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Changes

Changed in 1 of the 68 revisions of this API.1