Get Cost Report

GET /v1/organizations/cost_report

cURL

cURL

curl "https://api.anthropic.com/v1/organizations/cost_report\
?starting_at=2025-08-01T00:00:00Z\
&group_by[]=workspace_id\
&group_by[]=description\
&limit=1" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

200

{
  "data": [
    {
      "starting_at": "<string>",
      "ending_at": "<string>",
      "results": [
        {
          "currency": "<string>",
          "amount": "<string>",
          "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
          "description": "Claude Sonnet 4 Usage - Input Tokens",
          "cost_type": "tokens",
          "context_window": "0-200k",
          "model": "claude-sonnet-4-20250514",
          "service_tier": "standard",
          "token_type": "uncached_input_tokens"
        }
      ]
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

Headers

x-api-key · string · required

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console.

anthropic-version · string · required

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Query Parameters

limit · integer · default: 7

Maximum number of time buckets to return in the response.

Required range: 1 <= x <= 31

page · string<date-time> | null

Optionally set to the next_page token from the previous response.

Example:

"page_MjAyNS0wNS0xNFQwMDowMDowMFo="

starting_at · string<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.

ending_at · string<date-time> | null

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

Example:

"2024-10-30T23:58:27.427722Z"

group_by[] · enum<string>[] | null

Group by any subset of the available options.

Available options: workspace_id, description

Example:

"workspace_id"

bucket_width · enum<string> · default: 1d

Time granularity of the response data.

Available options: 1d

Allowed value: "1d"

Response

200

application/json

Successful Response

data · CostReportTimeBucket · object[] · required

Show child attributes

data. starting_at · string · required

Start of the time bucket (inclusive) in RFC 3339 format.

data. ending_at · string · required

End of the time bucket (exclusive) in RFC 3339 format.

data. results · CostReportItem · object[] · required

List of cost items for this time bucket. There may be multiple items if one or more group_by[] parameters are specified.

Show child attributes

data.results. currency · string · required

Currency code for the cost amount. Currently always "USD".

data.results. amount · string · required

Cost amount in lowest currency units (e.g. cents) as a decimal string. For example, "123.45" in "USD" represents $1.23.

data.results. workspace_id · string | null · required

ID of the Workspace this cost is associated with. Null if not grouping by workspace or for the default workspace.

Example:

"wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"

data.results. description · string | null · required

Description of the cost item. Null if not grouping by description.

Example:

"Claude Sonnet 4 Usage - Input Tokens"

data.results. cost_type · enum<string> | null · required

Type of cost. Null if not grouping by description.

Available options: tokens, web_search, code_execution

Example:

"tokens"

data.results. context_window · enum<string> | null · required

Input context window used. Null if not grouping by description or for non-token costs.

Available options: 0-200k, 200k-1M

Example:

"0-200k"

data.results. model · string | null · required

Model name used. Null if not grouping by description or for non-token costs.

Example:

"claude-sonnet-4-20250514"

data.results. service_tier · enum<string> | null · required

Service tier used. Null if not grouping by description or for non-token costs.

Available options: standard, batch

Example:

"standard"

data.results. token_type · enum<string> | null · required

Type of token. Null if not grouping by description or for non-token costs.

Available options: uncached_input_tokens, output_tokens, cache_read_input_tokens, cache_creation.ephemeral_1h_input_tokens, cache_creation.ephemeral_5m_input_tokens

Example:

"uncached_input_tokens"

has_more · boolean · required

Indicates if there are more results.

next_page · string<date-time> | null · required

Token to provide in as page in the subsequent request to retrieve the next page of data.

Example:

"page_MjAyNS0wNS0xNFQwMDowMDowMFo="