ANanthropics

Get Cost Report

Changed on

[Legacy] Get a report of your organization's Claude API costs in USD, aggregated into daily buckets.

This endpoint is part of the legacy Usage and Cost API. For new integrations, use GET /v1/organizations/analytics/cost in the Usage and Cost Analytics API instead. To move an existing integration, see Migrate from the Usage and Cost API.

get/v1/organizations/cost_report?beta=true

Request

  • Base URL
    https://api.anthropic.com
  • Auth
    none declared

Query parameters

limitinteger

Maximum number of time buckets to return in the response.

Example:7
pagestring nullable

Optionally set to the next_page token from the previous response.

Example:page_MjAyNS0wNS0xNFQwMDowMDowMFo=
starting_atstring date-time required

Time buckets that start on or after this RFC 3339 timestamp will be returned. Each time bucket will be snapped to the start of the minute/hour/day in UTC.

Example:2024-10-30T23:58:27.427722Z
ending_atstring date-time nullable

Time buckets that end before this RFC 3339 timestamp will be returned.

Example:2024-10-30T23:58:27.427722Z
group_by[]BetaCostReportGroupBy[] nullable

Group by any subset of the available options.

bucket_width'1d'

Time granularity of the response data.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

has_moreboolean required

Indicates if there are more results.

next_pagestring nullable required

Opaque cursor for the next page, or null when has_more is false. Pass it as the page parameter in the next request.

Example response

{
  "data": [
    {
      "starting_at": "2025-08-01T00:00:00Z",
      "ending_at": "2025-08-02T00:00:00Z",
      "results": [
        {
          "currency": "USD",
          "amount": "123.78912",
          "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
          "description": "Claude Opus 5.5 Usage - Input Tokens",
          "model": "claude-opus-5-5"
        }
      ]
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

Changes

  • 037a593978dcRevision changes
    • info

      added the enum value admin-user-sign-out-2026-10-08 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta

  • f538a797852cRevision changes
    • info

      added the enum value experimental-claude-tag-2026-10-21 to the property items/anyOf[subschema #2]/ of the header request parameter anthropic-beta