Claude adds a usage and cost API that splits bills by model, workspace and API key
Synopsis
Anthropic released a beta Usage and Cost Analytics API on the Claude Platform, with two organization-level endpoints that report token usage and cost for Claude Console and Claude Enterprise organizations and let callers filter and group results by dimensions such as model, workspace, API key, and the user or service account behind each request. The same data previously came from the Usage and Cost API and four report endpoints of the Claude Enterprise Analytics API, which are now legacy but remain supported, with two documented migration paths. The new endpoints require the analytics-usage-cost-2026-08-24 beta header.
Interpretation
The Claude Platform now exposes organization-level analytics endpoints that return token usage and cost as queryable data, covering both Claude Console and Claude Enterprise organizations. That data previously came from the Usage and Cost API and the usage_report, cost_report, user_usage_report and user_cost_report endpoints of the Claude Enterprise Analytics API, which are now labeled legacy. The two new endpoints are /v1/organizations/analytics/usage and /v1/organizations/analytics/cost, opened in beta under the analytics-usage-cost-2026-08-24 beta header.
Results can be filtered and grouped by dimension, so operators can attribute spend to a specific model, workspace, key or caller. The listed grouping dimensions are model, workspace, API key, and the user or service account behind each request. That dimension list ships with the beta and applies to Claude Console and Claude Enterprise organizations.
The older interfaces are not switched off, and existing integrations can move using the published migration notes. The four legacy report endpoints and the legacy Usage and Cost API all remain supported. The platform gives two migration paths: from the Usage and Cost API, and from the Claude Enterprise usage and cost reports.
Perspective
The release notes describe organization-level usage and cost queries for Claude Console and Claude Enterprise organizations; the endpoints are in beta and require the named beta header, while the legacy interfaces remain supported and migration paths are documented separately.
The new endpoints ship in beta and the release notes give no general-availability date; the legacy Usage and Cost API and the four report endpoints remain supported, but no support window is stated.