Users changedapi/admin/analytics/users
Nearest release: v2.1.245, published an hour after 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+42added
Lines−37removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits5to this page, all time
### Query parameters #### Response (200) ## Domain types ### Query Parameters #### Response ## Domain Types
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Users
3url: https://platform.claude.com/docs/en/api/admin/analytics/users
4---
5
61# Users
72
83## List User Activity
94
10**get** `/v1/organizations/analytics/users`
5**GET** `/v1/organizations/analytics/users`
116
127Get per-user activity for a given day, with cursor-based pagination.
138
from line 12
1712to organizations on a Claude Enterprise plan. Requires an API key with
1813the `read:analytics` scope.
1914
20### Query Parameters
15### Query parameters
2116
2217- `date: optional string`
2318
2419 UTC date in YYYY-MM-DD format. The day to get user activity for. Data is typically available with a 1-day lag (varies by query; the error for a too-recent date names the latest available day) and may be revised by a few percent over the following days. No earlier than 2026-01-01.
2520
21 format: date
22
2623- `ending_date: optional string`
2724
2825 UTC date in YYYY-MM-DD format. End of the date range (exclusive); only valid with starting_date. Data is typically available with a 1-day lag (varies by query; the error for a too-recent date names the latest available day), so this can be at most today — which is also the default when omitted, resolved once when the first page is served and reused for the rest of the pagination sequence. At most 366 days after starting_date.
2926
27 format: date
28
3029- `filter: optional array of string`
3130
3231 Filters as 'dimension:value', e.g. filter[]=rbac_group_id:<id>. Repeat the param for OR within a dimension and across dimensions for AND. Supported dimensions on this endpoint: project_id, rbac_group_id, user_id. Value forms: project_id takes a tagged project id (claude_proj_...) and scopes each member's row to their claude.ai chat activity within that project (it cannot be combined with group_by[] or an rbac_group_id filter); rbac_group_id takes the tagged id (rbac_group_..., as emitted in responses and by the spend-limits API) or a bare group UUID, and matches users who held the group at any point during each covered UTC day (time-of-usage attribution); user_id takes a tagged user id (user_...), as emitted in responses. An unsupported dimension returns 400. At most 100 entries.
3332
33 maxItems: 100
34
3435- `group_by: optional array of "rbac_group_id"`
3536
3637 Dimensions to break results out by (e.g. group_by[]=rbac_group_id). Supported on this endpoint: rbac_group_id. Rows are already per-member, so the one supported grouping aggregates them per RBAC group instead. Grouped rows carry the requested dimension values as additional fields and paginate like ungrouped responses via next_page; an unsupported dimension returns 400. rbac_group_id attributes a user to every group they held at any point during each covered UTC day, so grouped rows are not an exclusive partition and can sum above org-level totals. At most 100 entries.
3738
38 - `"rbac_group_id"`
39 maxItems: 100
3940
4041- `limit: optional number`
4142
4243 Number of results per page (1-1000, default 100).
4344
45 minimum: 1, maximum: 1000
46
4447- `order: optional "asc" or "desc"`
4548
4649 Sort direction: 'asc' or 'desc'. Defaults to 'asc' for the endpoint's sort column and to 'desc' when order_by names a metric (a top-N ranking). Applies to order_by, or to the endpoint's default sort field when order_by is omitted.
from line 64
6164
6265 UTC date in YYYY-MM-DD format. Start of a date range (inclusive). Enables rollup mode: one row per entity aggregated over the whole range — addable counters are summed across days, and a distinct count is never summed where summing could double-count (a field's range value is recomputed exactly over the window, approximate via HLL with typical error under 2%, null, or — for the creation-event counts, whose per-day values cannot overlap — a per-day sum that is itself exact; each field's own description says which). Use either date or starting_date, not both. Data is typically available with a 1-day lag (varies by query; the error for a too-recent date names the latest available day) and may be revised by a few percent over the following days. No earlier than 2026-01-01.
6366
67 format: date
68
6469### Returns
6570
66- `UserActivity object { data, next_page }`
71- `UserActivity object`
6772
6873 Response for GET /v1/organizations/analytics/users.
6974
70 - `data: array of object { chat_metrics, claude_code_metrics, cowork_metrics, 9 more }`
75 - `data: array of object`
7176
72 - `chat_metrics: object { connectors_used_count, distinct_artifacts_created_count, distinct_connectors_used_count, 9 more }`
77 - `chat_metrics: object`
7378
7479 Claude.ai activity metrics for a single user on a given day.
7580
from line 126
121126
122127 Number of messages that used extended thinking
123128
124 - `claude_code_metrics: object { core_metrics, tool_actions }`
129 - `claude_code_metrics: object`
125130
126131 Claude Code activity metrics for a single user on a given day.
127132
128 - `core_metrics: object { commit_count, distinct_session_count, lines_of_code, pull_request_count }`
133 - `core_metrics: object`
129134
130135 Core Claude Code activity metrics for a single user on a given day.
131136
from line 142
137142
138143 Number of distinct Claude Code sessions. On aggregated rows and in date-range mode: summed per-day distinct counts. A session essentially never spans a UTC day, so the sum is in practice the true distinct count.
139144
140 - `lines_of_code: object { added_count, removed_count }`
145 - `lines_of_code: object`
141146
142147 Lines of code added and removed via Claude Code.
143148
from line 158
153158
154159 Number of pull requests created via Claude Code
155160
156 - `tool_actions: object { edit_tool, multi_edit_tool, notebook_edit_tool, write_tool }`
161 - `tool_actions: object`
157162
158163 Per-tool accepted/rejected counts for Claude Code file modification tools.
159164
from line 186
181186
182187 Accepted/rejected counts for a single Claude Code tool type.
183188
184 - `cowork_metrics: object { action_count, connectors_used_count, dispatch_turn_count, 13 more }`
189 - `cowork_metrics: object`
185190
186191 Cowork activity metrics for a single user on a given day.
187192
from line 254
249254
250255 Number of successful Write tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
251256
252 - `design_metrics: object { distinct_projects_created_count, distinct_projects_used_count, distinct_session_count, message_count }`
257 - `design_metrics: object`
253258
254259 Claude Design activity metrics for a single user on a given day.
255260
from line 274
269274
270275 Number of messages sent in Claude Design sessions
271276
272 - `office_metrics: object { excel, outlook, powerpoint, word }`
277 - `office_metrics: object`
273278
274279 Office Agent activity metrics for a single user on a given day, broken out by Office product.
275280
from line 318
313318
314319 Office Agent activity metrics for a single user on a given day within one Office product.
315320
316 - `science_metrics: object { delegation_count, distinct_session_count, message_count, 2 more }`
321 - `science_metrics: object`
317322
318323 Claude Science activity metrics for a single user on a given day.
319324
from line 378
373378
374379 Object type. Always `user`.
375380
376 - `"user"`
381 default: user
377382
378383 - `next_page: string or null`
379384
from line 386
381386
382387### Example
383388
384```http
389```bash
385390curl https://api.anthropic.com/v1/organizations/analytics/users \
386391 -H 'anthropic-version: 2023-06-01' \
387392 -H "X-Api-Key: $ANTHROPIC_ADMIN_API_KEY"
388393```
389394
390#### Response
395#### Response (200)
391396
392397```json
393398{
from line 522
517522}
518523```
519524
520## Domain Types
525## Domain types
521526
522527### User Activity
523528
524- `UserActivity object { data, next_page }`
529- `UserActivity object`
525530
526531 Response for GET /v1/organizations/analytics/users.
527532
528 - `data: array of object { chat_metrics, claude_code_metrics, cowork_metrics, 9 more }`
533 - `data: array of object`
529534
530 - `chat_metrics: object { connectors_used_count, distinct_artifacts_created_count, distinct_connectors_used_count, 9 more }`
535 - `chat_metrics: object`
531536
532537 Claude.ai activity metrics for a single user on a given day.
533538
from line 584
579584
580585 Number of messages that used extended thinking
581586
582 - `claude_code_metrics: object { core_metrics, tool_actions }`
587 - `claude_code_metrics: object`
583588
584589 Claude Code activity metrics for a single user on a given day.
585590
586 - `core_metrics: object { commit_count, distinct_session_count, lines_of_code, pull_request_count }`
591 - `core_metrics: object`
587592
588593 Core Claude Code activity metrics for a single user on a given day.
589594
from line 600
595600
596601 Number of distinct Claude Code sessions. On aggregated rows and in date-range mode: summed per-day distinct counts. A session essentially never spans a UTC day, so the sum is in practice the true distinct count.
597602
598 - `lines_of_code: object { added_count, removed_count }`
603 - `lines_of_code: object`
599604
600605 Lines of code added and removed via Claude Code.
601606
from line 616
611616
612617 Number of pull requests created via Claude Code
613618
614 - `tool_actions: object { edit_tool, multi_edit_tool, notebook_edit_tool, write_tool }`
619 - `tool_actions: object`
615620
616621 Per-tool accepted/rejected counts for Claude Code file modification tools.
617622
from line 644
639644
640645 Accepted/rejected counts for a single Claude Code tool type.
641646
642 - `cowork_metrics: object { action_count, connectors_used_count, dispatch_turn_count, 13 more }`
647 - `cowork_metrics: object`
643648
644649 Cowork activity metrics for a single user on a given day.
645650
from line 712
707712
708713 Number of successful Write tool calls in Cowork sessions. Null while the file-edit metrics are not enabled for this organization.
709714
710 - `design_metrics: object { distinct_projects_created_count, distinct_projects_used_count, distinct_session_count, message_count }`
715 - `design_metrics: object`
711716
712717 Claude Design activity metrics for a single user on a given day.
713718
from line 732
727732
728733 Number of messages sent in Claude Design sessions
729734
730 - `office_metrics: object { excel, outlook, powerpoint, word }`
735 - `office_metrics: object`
731736
732737 Office Agent activity metrics for a single user on a given day, broken out by Office product.
733738
from line 776
771776
772777 Office Agent activity metrics for a single user on a given day within one Office product.
773778
774 - `science_metrics: object { delegation_count, distinct_session_count, message_count, 2 more }`
779 - `science_metrics: object`
775780
776781 Claude Science activity metrics for a single user on a given day.
777782
from line 836
831836
832837 Object type. Always `user`.
833838
834 - `"user"`
839 default: user
835840
836841 - `next_page: string or null`
837842
No line in this hunk matches that.