Usage Report changedapi/beta/organization/usage_report
Nearest release: v2.1.314, published 6 hours 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+10added
Lines−4removed
From line
9
where the diff opens
First seen
10 Sep 2026
this site's first read of the page
Recorded edits16to this page, all time
The whole hunk
from line 9, old and new numbered
/
from line 9
99
1010**GET** `/v1/organizations/usage_report/messages`
1111
12Get Messages Usage Report
12[Legacy] Get a report of your organization's Messages API usage, aggregated into time buckets.
1313
14This endpoint is part of the legacy Usage and Cost API. For new integrations, use [`GET /v1/organizations/analytics/usage`](https://platform.claude.com/docs/en/api/beta/organization/analytics/usage/list?sdk_languages=http) in the Usage and Cost Analytics API instead. To move an existing integration, see [Migrate from the Usage and Cost API](https://platform.claude.com/docs/en/manage-claude/usage-cost-analytics-api?sdk_languages=http#migrate-from-usage-cost-api).
15
1416### Query parameters
1517
1618- `starting_at: string`
from line 109
107109
108110 Restrict usage returned to the specified service account ID(s).
109111
110- `service_tiers: optional array of "batch" or "flex" or "flex_discount" or 3 more`
112- `service_tiers: optional array of BetaAnalyticsServiceTier`
111113
112114 Restrict usage returned to the specified service tier(s).
113115
from line 255
253255
254256 - `"webhooks-2026-10-07"`
255257
258 - `"message-threads-2026-08-12"`
259
260 - `"analytics-usage-cost-2026-08-24"`
261
256262### Returns
257263
258264- `BetaMessagesUsageReport object`
from line 344
338344
339345 ID of the service account that made the request. `null` if not grouping by service account or for non-OIDC-federation requests.
340346
341 - `service_tier: "batch" or "flex" or "flex_discount" or 3 more or null`
347 - `service_tier: BetaAnalyticsServiceTier or null`
342348
343349 Service tier used. `null` if not grouping by service tier.
344350
from line 954
948954
949955 ID of the service account that made the request. `null` if not grouping by service account or for non-OIDC-federation requests.
950956
951 - `service_tier: "batch" or "flex" or "flex_discount" or 3 more or null`
957 - `service_tier: BetaAnalyticsServiceTier or null`
952958
953959 Service tier used. `null` if not grouping by service tier.
954960
No line in this hunk matches that.