Follow Discord
Sweep 30 Oct 2026 · 01:02Z Build v2.1.314 532 read Stable v2.1.308 Latest v2.1.314 Next v2.1.314 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Developer Platform 29 Oct 2026
One change · api

Get Messages Usage Report changedapi/beta/organization/usage_report/retrieve_messages

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+9added
Lines−3removed
From line 7 where the diff opens
First seen 10 Sep 2026 this site's first read of the page
Recorded edits14to this page, all time

The whole hunk

from line 7, old and new numbered
/
lines
from line 7
77 
88**GET** `/v1/organizations/usage_report/messages`
99 
10Get Messages Usage Report
10[Legacy] Get a report of your organization's Messages API usage, aggregated into time buckets.
1111 
12This 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).
13 
1214## Query parameters
1315 
1416- `starting_at: string`
from line 107
105107 
106108 Restrict usage returned to the specified service account ID(s).
107109 
108- `service_tiers: optional array of "batch" or "flex" or "flex_discount" or 3 more`
110- `service_tiers: optional array of BetaAnalyticsServiceTier`
109111 
110112 Restrict usage returned to the specified service tier(s).
111113 
from line 253
251253 
252254 - `"webhooks-2026-10-07"`
253255 
256 - `"message-threads-2026-08-12"`
257 
258 - `"analytics-usage-cost-2026-08-24"`
259 
254260## Returns
255261 
256262- `BetaMessagesUsageReport object`
from line 342
336342 
337343 ID of the service account that made the request. `null` if not grouping by service account or for non-OIDC-federation requests.
338344 
339 - `service_tier: "batch" or "flex" or "flex_discount" or 3 more or null`
345 - `service_tier: BetaAnalyticsServiceTier or null`
340346 
341347 Service tier used. `null` if not grouping by service tier.
342348 
Feedback