Get Token Usage By Dimension changedapi/beta/organization/analytics/usage/list
Nearest release: v2.1.322, published 2 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+27added
Lines−12removed
From line
47
where the diff opens
First seen
10 Sep 2026
this site's first read of the page
Recorded edits6to this page, all time
The whole hunk
from line 47, old and new numbered
/
from line 47
4747
4848- `agent_ids: optional array of string`
4949
50 Filter to usage incurred by sessions of specific Claude Managed Agents agents. Use `group_by[]=agent_id` to break out per-agent values. Claude Developer Platform organizations only.
50 Filter to usage incurred by sessions of specific Claude Managed Agents agents. Use `group_by[]=agent_id` to break out per-agent values. Claude Platform organizations only.
5151
5252 maxItems: 100
5353
5454- `api_key_ids: optional array of string`
5555
56 Filter to usage authenticated by specific API keys, by tagged API key ID (`apikey_...`), whichever identity the usage is attributed to. Include an empty entry (`api_key_ids[]=`) to also match usage that no API key authenticated. Use `group_by[]=api_key_id` to break out per-key values; usage without a key has a null `api_key_id`. Claude Developer Platform organizations only.
56 Filter to usage authenticated by specific API keys, by tagged API key ID (`apikey_...`), whichever identity the usage is attributed to. Include an empty entry (`api_key_ids[]=`) to also match usage that no API key authenticated. Use `group_by[]=api_key_id` to break out per-key values; usage without a key has a null `api_key_id`. Claude Platform organizations only.
5757
5858 maxItems: 100
5959
6060- `claude_tag_categories: optional array of BetaAnalyticsClaudeTagCategory`
6161
62 Filter to Claude Tag (Claude in Slack) usage in specific spend categories. Usage with no category never matches. `dm` usage is reported under the user's product rather than `claude_tag`, so combining this filter with `products[]=claude_tag` excludes it. Use `group_by[]=claude_tag_category` to break out per-category values.
62 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.
6363
6464 maxItems: 100
6565
from line 91
9191
9292- `deployment_ids: optional array of string`
9393
94 Filter to usage incurred by Claude Managed Agents sessions that specific deployments started. Use `group_by[]=deployment_id` to break out per-deployment values. Claude Developer Platform organizations only.
94 Filter to usage incurred by Claude Managed Agents sessions that specific deployments started. Use `group_by[]=deployment_id` to break out per-deployment values. Claude Platform organizations only.
9595
9696 maxItems: 100
9797
from line 103
103103
104104- `environment_ids: optional array of string`
105105
106 Filter to usage incurred by Claude Managed Agents sessions that ran in specific environments. Use `group_by[]=environment_id` to break out per-environment values. Claude Developer Platform organizations only.
106 Filter to usage incurred by Claude Managed Agents sessions that ran in specific environments. Use `group_by[]=environment_id` to break out per-environment values. Claude Platform organizations only.
107107
108108 maxItems: 100
109109
from line 141
141141
142142 - `"model"`
143143
144 - `"organization_id"`
145
144146 - `"product"`
145147
146148 - `"rbac_group_id"`
from line 205
203205
204206 - `"uncached_input_tokens"`
205207
208- `organization_ids: optional array of string`
209
210 Filter a parent organization's report to specific child organizations, by organization UUID or `org_` ID; an ID that is not one of its child organizations matches nothing. Requires an API key created at the parent organization level. Use `group_by[]=organization_id` to break out per-organization values.
211
212 maxItems: 100
213
206214- `page: optional string`
207215
208216 Opaque cursor from a previous response's `next_page` field.
from line 253
245253
246254- `service_tiers: optional array of BetaAnalyticsServiceTier`
247255
248 Filter to specific service tiers. Use `group_by[]=service_tier` to break out per-tier values. Claude Developer Platform organizations only; matches nothing for a Claude Enterprise organization.
256 Filter to specific service tiers. Use `group_by[]=service_tier` to break out per-tier values. Claude Platform organizations only; matches nothing for a Claude Enterprise organization.
249257
250258 maxItems: 100
251259
from line 271
263271
264272- `session_ids: optional array of string`
265273
266 Filter to usage incurred by specific Claude Managed Agents sessions, by tagged session ID (`sesn_...`). Use `group_by[]=session_id` to break out per-session values. Claude Developer Platform organizations only.
274 Filter to usage incurred by specific Claude Managed Agents sessions, by tagged session ID (`sesn_...`). Use `group_by[]=session_id` to break out per-session values. Claude Platform organizations only.
267275
268276 maxItems: 100
269277
from line 303
295303
296304- `user_profile_ids: optional array of string`
297305
298 Filter to usage attributed to specific user profiles, by tagged user profile ID (`uprof_...`). Use `group_by[]=user_profile_id` to break out per-profile values. Claude Developer Platform organizations only.
306 Filter to usage attributed to specific user profiles, by tagged user profile ID (`uprof_...`). Use `group_by[]=user_profile_id` to break out per-profile values. Claude Platform organizations only.
299307
300308 maxItems: 100
301309
302310- `workspace_ids: optional array of string`
303311
304 Filter to usage in specific workspaces, by tagged workspace ID (`wrkspc_...`). Use `group_by[]=workspace_id` to break out per-workspace values. Claude Developer Platform organizations only; matches nothing for a Claude Enterprise organization.
312 Filter to usage in specific workspaces, by tagged workspace ID (`wrkspc_...`). Use `group_by[]=workspace_id` to break out per-workspace values. Claude Platform organizations only; matches nothing for a Claude Enterprise organization.
305313
306314 maxItems: 100
307315
from line 321
313321
314322 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
315323
316- `"anthropic-beta": optional array of AnthropicBeta`
324- `"anthropic-beta": array of AnthropicBeta`
317325
318326 This endpoint is in beta: requests must send `analytics-usage-cost-2026-08-24` in this header.
319327
from line 431
423431
424432 - `"webhooks-2026-10-07"`
425433
434 - `"admin-user-sign-out-2026-10-08"`
435
426436 - `"message-threads-2026-08-12"`
427437
428438 - `"analytics-usage-cost-2026-08-24"`
from line 567
557567
558568 - `claude_tag_category: BetaAnalyticsClaudeTagCategory or null`
559569
560 Claude Tag (Claude in Slack) spend category: `engaged` (a person addressed Claude in a channel or thread), `proactive` (Claude responded without being addressed), `scheduled` (a scheduled routine ran), `monitoring` (Claude watching a channel it was asked to monitor), or `dm` (direct messages with Claude). Populated only when `claude_tag_category` is in `group_by[]`; null for usage that is not Claude Tag. Direct-message usage is billed to the individual user and is reported under that user's product, not under `claude_tag`. New categories may be added over time.
570 Claude Tag (Claude in Slack) spend category: `engaged` (a person addressed Claude in a channel or thread), `proactive` (Claude responded without being addressed), `scheduled` (a scheduled routine ran), `monitoring` (Claude watching a channel it was asked to monitor), or `dm` (direct messages with Claude). Populated only when `claude_tag_category` is in `group_by[]`; null for usage that is not Claude Tag. New categories may be added over time.
561571
562572 - `"dm"`
563573
from line 611
601611
602612 Model that produced the usage or cost, as a model name in the form the `models[]` filter accepts (for example, `claude-opus-5-5`). Null unless `model` is in `group_by[]`; it can also be null on grouped rows whose usage or cost is not attributed to a specific model, such as code execution.
603613
614 - `organization_id: string or null`
615
616 UUID of the child organization the usage belongs to, on a parent organization's report across its children. Null unless `organization_id` is in `group_by[]`.
617
604618 - `product: string or null`
605619
606620 Product surface that produced the usage or cost. Null unless product is in `group_by[]`; it can also be null on grouped rows whose usage cannot be attributed to a known surface. Values include `chat`, `claude_code`, `cowork`, `office_agent`, `claude_in_chrome`, `claude_design`, `claude_tag`, and `chat_cowork_unified`. `claude_tag` is Claude Tag, the Claude product in Slack. `chat_cowork_unified` is Chat and Cowork unified, Cowork's features inside claude.ai chat: chat and Cowork usage by a member who has it turned on is reported under this value instead of `chat` or `cowork`. It is accepted as a filter only where Chat and Cowork unified is available. Some unattributed usage is reported as "other".
from line 645
631645
632646 - `slack_channel_id: string or null`
633647
634 Slack channel the usage originated from. Populated only when `slack_channel_id` is in `group_by[]`; null for usage outside Slack (and for rows recorded before channel attribution was enabled).
648 Slack channel the usage originated from. Populated only when `slack_channel_id` is in `group_by[]`; null for usage outside Slack, for some Claude Tag usage that has no channel recorded, and for usage recorded before channel attribution was enabled.
635649
636650 - `speed: BetaAnalyticsSpeed or null`
637651
from line 765
751765 "environment_id": "env_017oTjuGedHtjhJauVC5xGJD",
752766 "inference_geo": "global",
753767 "model": "claude-opus-5-5",
768 "organization_id": "12345678-1234-5678-1234-567812345678",
754769 "product": "chat",
755770 "rbac_group_id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
756771 "service_tier": "standard",
No line in this hunk matches that.