Claude Platform Docs

Get Per-User Cost

client.beta.organization.analytics.userCostReport.list(query, options?): ReportPageCursor<BetaAnalyticsCostUsersItem>
GET/v1/organizations/analytics/user_cost_report

[Legacy] Get per-user cost in USD across a date range.

Returns cost per user, ranked by spend; group_by[] or bucket_width splits a user across several rows. Use this to see which users account for the most cost. Only cost attributed to a user account is included, so cost with no user account, such as Code Review usage and Claude Tag usage in Slack channels, is left out. Claude Tag one-to-one direct messages are included, with product claude-tag, only for members who have connected a Claude account. Available to organizations on a Claude Enterprise plan. Requires an API key with the read:analytics scope.

This endpoint is one of the legacy Claude Enterprise usage and cost reports. For new integrations, use GET /v1/organizations/analytics/cost in the Usage and Cost Analytics API instead. To move an existing integration, see Migrate from the Claude Enterprise usage and cost reports.

Parameters
query: UserCostReportListParams { starting_at; bucket_width; claude_tag_categories; /* 16 more */ }
starting_at: string⁠Query parameter

Start of range, inclusive. RFC 3339 tz-aware. Must be within the last 365 days and no earlier than 2026-01-01T00:00:00Z.

formatdate-time
bucket_width?: "1d" | "1h" | "1m" | null⁠Query parameter

Time-bucket granularity. When set, each row's starting_at and ending_at are populated and one actor may span several rows (one per time bucket with usage). The time bucket counts toward limit, so one page can return multiple rows for the same actor. ending_at is required when bucket_width is set, and with bucket_width="1m" the range may span at most 24 hours. When omitted, each row aggregates the full [starting_at, ending_at) range.

One of the following:
"1d"
"1h"
"1m"
claude_tag_categories?: Array<BetaAnalyticsClaudeTagCategory> | null⁠Query parameter

Filter to Claude Tag (Claude in Slack) usage in specific spend categories. Usage with no category never matches. Use group_by[]=claude_tag_category to break out per-category values.

maxItems100
One of the following:
"dm"
"engaged"
"monitoring"
"proactive"
"scheduled"
claude_tag_user_ids?: Array<string> | null⁠Query parameter

Filter to Claude Tag (Claude in Slack) usage attributed to specific Slack users, by Slack user ID (for example U0123ABCDEF), not claude.ai user ID. Usage that is not Claude Tag, and Claude Tag usage not attributed to a single user, never matches. Use group_by[]=claude_tag_user_id to break out per-user values.

maxItems100
context_windows?: Array<BetaAnalyticsContextWindow> | null⁠Query parameter

Filter to specific context-window pricing tiers. Use group_by[]=context_window to break out per-tier values.

maxItems100
One of the following:
"0-200k"
"200k-1M"
ending_at?: string | null⁠Query parameter

End of range, exclusive. When omitted, defaults to the earlier of now and starting_at + 31 days. The range may span at most 31 days.

formatdate-time
exclude_deleted_users?: boolean⁠Query parameter

If true, omit rows for users who are deleted (deleted: true). A page may contain fewer than limit rows; use has_more and next_page to paginate as usual.

group_by?: Array<"claude_tag_category" | "claude_tag_user_id" | "context_window" | 8 more> | null⁠Query parameter

Break each actor's row out by the given dimensions. Accepts the same values as the bucketed /cost_report endpoint. The product, model, context_window, inference_geo, and speed dimensions — and the time bucket, when bucket_width is set — count toward limit. cost_type and token_type do not: cost_type returns one row per cost component (tokens, web search, code execution); token_type returns one row per token type, each with cost_type: "tokens"; combining both returns the per-token-type rows plus the web-search and code-execution rows. A page can therefore contain more rows than limit when cost_type or token_type is requested.

maxItems100
One of the following:
"claude_tag_category"
"claude_tag_user_id"
"context_window"
"cost_type"
"inference_geo"
"model"
"product"
"rbac_group_id"
"slack_channel_id"
"speed"
"token_type"
inference_geos?: Array<BetaAnalyticsInferenceGeoFilter> | null⁠Query parameter

Filter to specific inference regions. not_available matches rows where the region is unset. Use group_by[]=inference_geo to break out per-region values.

maxItems100
One of the following:
"global"
"not_available"
"us"
limit?: number⁠Query parameter

Number of rows per page (1-1000, default 20). One row per actor unless group_by[] or bucket_width splits an actor across rows; cost_type/token_type fan-out rows (cost endpoint only) are the exception — they do not count toward this limit, so data can exceed it.

minimum1
maximum1000
models?: Array<string> | null⁠Query parameter

Models to include. Defaults to all models. Use group_by[]=model to break out per-model values.

maxItems100
order?: "asc" | "desc"⁠Query parameter

Sort direction. Defaults to desc.

One of the following:
"asc"
"desc"
order_by?: "amount" | "list_amount"⁠Query parameter

Metric to rank actors by. Defaults to amount.

One of the following:
"amount"
"list_amount"
page?: string | null⁠Query parameter

Opaque cursor from a previous response's next_page field.

products?: Array<BetaAnalyticsProductFilter> | null⁠Query parameter

Product surfaces to include. Defaults to all products.

maxItems100
One of the following:
"chat"
"chat_cowork_unified"
"claude-tag"
"claude_code"
"claude_design"
"claude_in_chrome"
"cowork"
"office_agent"
rbac_group_ids?: Array<string> | null⁠Query parameter

Filter to usage attributed to specific RBAC groups. Accepts tagged RBAC group IDs (rbac_group_...) or bare group UUIDs. A row matches when the user belonged to any of the listed groups on the (UTC) day the usage occurred; usage with no group attribution never matches.

maxItems100
slack_channel_ids?: Array<string> | null⁠Query parameter

Filter to usage originating from specific Slack channels. Use group_by[]=slack_channel_id to break out per-channel values.

maxItems100
speeds?: Array<"fast" | "standard"> | null⁠Query parameter

Filter to fast or standard inference mode. Use group_by[]=speed to break out per-mode values.

maxItems100
One of the following:
"fast"
"standard"
user_ids?: Array<string> | null⁠Query parameter

Filter to specific users by tagged user ID.

maxItems100
Returns
interface BetaAnalyticsCostUsersItem { actor; amount; claude_tag_category; /* 15 more */ }
Get Per-User Cost
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env["ANTHROPIC_API_KEY"] // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const betaAnalyticsCostUsersItem of client.beta.organization.analytics.userCostReport.list(
  { starting_at: "2019-12-27T18:11:19.117Z" }
)) {
  console.log(betaAnalyticsCostUsersItem.claude_tag_user_id);
}
Returns Examples
Response 200
{
  "data": [
    {
      "actor": {
        "deleted": true,
        "email_address": "jane@example.com",
        "name": "Jane Smith",
        "type": "user_actor",
        "user_id": "user_01AbCdEfGhIjKlMnOpQrSt"
      },
      "amount": "41280.000000",
      "claude_tag_category": "dm",
      "claude_tag_user_id": "U0123ABCDEF",
      "context_window": "0-200k",
      "cost_type": "code_execution",
      "currency": "USD",
      "ending_at": "2019-12-27T18:11:19.117Z",
      "inference_geo": "global",
      "list_amount": "51600.000000",
      "model": "claude-opus-5-5",
      "product": "chat",
      "rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
      "requests": 128,
      "slack_channel_id": "C0123ABCDEF",
      "speed": "fast",
      "starting_at": "2019-12-27T18:11:19.117Z",
      "token_type": "cache_creation.ephemeral_1h_input_tokens"
    }
  ],
  "data_refreshed_at": "2019-12-27T18:11:19.117Z",
  "has_more": true,
  "next_page": "next_page",
  "organization_id": "org_013FP9SaFPBg7Kw7fetjn6cF"
}