First request changedmanage-claude/usage-cost-api
Nearest release: v2.1.312, published under an hour 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+9added
Lines−9removed
From line
16
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits15to this page, all time
### What’s the recommended polling frequency? ### What's the recommended polling frequency?
The whole hunk
from line 16, old and new numbered
/
from line 16
1616* **Cost reconciliation:** Match internal records with Anthropic billing for finance and accounting teams
1717* **Product performance and improvement:** Monitor product performance while measuring if changes to the system have improved it, or set up alerting
1818* **[Rate limit](https://platform.claude.com/docs/en/api/rate-limits) optimization:** Optimize features such as [prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) or specific prompts to use your allocated capacity efficiently.
19* **Advanced analysis:** Perform deeper data analysis than what's available in Console
19* **Advanced analysis:** Perform deeper data analysis than what’s available in Console
2020
2121<Check>
22 **Admin API credentials required.** These endpoints are part of the Admin API. You can access them using an [Admin API key](https://platform.claude.com/docs/en/manage-claude/admin-api-keys), an OAuth token with the `org:admin` scope, or a personal or service account key that isn't scoped to a workspace; workspace API keys don't work. See [Authentication](https://platform.claude.com/docs/en/manage-claude/admin-api#authentication) for details.
22 **Admin API credentials required.** These endpoints are part of the Admin API. You can access them using an [Admin API key](https://platform.claude.com/docs/en/manage-claude/admin-api-keys), an OAuth token with the `org:admin` scope, or a personal or service account key that isn’t scoped to a workspace; workspace API keys don’t work. See [Authentication](https://platform.claude.com/docs/en/manage-claude/admin-api#authentication) for details.
2323</Check>
2424
2525Claude Enterprise organizations use an Analytics API key with a different API instead; see [Which API do you need?](https://platform.claude.com/docs/en/manage-claude/usage-cost-api#which-api-do-you-need).
from line 79
7979
8080## Quick start
8181
82Get your organization's daily usage for the last 7 days:
82Get your organization’s daily usage for the last 7 days:
8383
8484```bash cURL
8585curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
from line 93
9393<Tip>
9494 **Set a User-Agent header for integrations**
9595
96 If you're building an integration, set your User-Agent header to help Anthropic understand usage patterns:
96 If you’re building an integration, set your User-Agent header to help Anthropic understand usage patterns:
9797
9898 ```text wrap
9999 User-Agent: YourApp/1.0.0 (https://yourapp.com)
from line 157
157157```
158158
159159<Tip>
160 To retrieve your organization's API key IDs, use the [List API Keys](https://platform.claude.com/docs/en/api/organization/api_keys/list) endpoint.
160 To retrieve your organization’s API key IDs, use the [List API Keys](https://platform.claude.com/docs/en/api/organization/api_keys/list) endpoint.
161161
162 To retrieve your organization's workspace IDs, use the [List Workspaces](https://platform.claude.com/docs/en/api/organization/workspaces/list) endpoint, or find your organization's workspace IDs in the Claude Console.
162 To retrieve your organization’s workspace IDs, use the [List Workspaces](https://platform.claude.com/docs/en/api/organization/workspaces/list) endpoint, or find your organization’s workspace IDs in the Claude Console.
163163</Tip>
164164
165165#### Data residency
from line 191
191191```
192192
193193<Note>
194 Models released before February 2026 (prior to Claude Opus 4.6 and Claude Sonnet 4.6) don't support the `inference_geo` request parameter, so their usage reports return `"not_available"` for this dimension. You can use `not_available` as a filter value in `inference_geos[]` to target those models.
194 Models released before February 2026 (prior to Claude Opus 4.6 and Claude Sonnet 4.6) don’t support the `inference_geo` request parameter, so their usage reports return `"not_available"` for this dimension. You can use `not_available` as a filter value in `inference_geos[]` to target those models.
195195</Note>
196196
197197#### Fast mode
from line 304
304304
305305Usage and cost data typically appears within 5 minutes of API request completion, though delays might occasionally be longer.
306306
307### What's the recommended polling frequency?
307### What’s the recommended polling frequency?
308308
309309The API supports polling once per minute for sustained use. For short bursts (for example, downloading paginated data), more frequent polling is acceptable. Cache results for dashboards that need frequent updates.
310310
No line in this hunk matches that.