curl -X GET 'https://api.anthropic.com/v1/organizations/cost_report?beta=true&limit=7&page=example-page&starting_at=example-starting-at&ending_at=example-ending-at&group_by%5B%5D=example&bucket_width=1d' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01'

# GET /v1/organizations/cost_report?beta=true (Claude API)
Base URL: https://api.anthropic.com
Auth: x-api-key; Anthropic API key; required.
Status: Beta.
Last verified: 2026-10-20

> Get Cost Report

## Critical Gotchas
* Authentication uses the `x-api-key` header and requests also require an `anthropic-version` header.
* The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

## cURL
curl -X GET 'https://api.anthropic.com/v1/organizations/cost_report?beta=true&limit=7&page=example-page&starting_at=example-starting-at&ending_at=example-ending-at&group_by%5B%5D=example&bucket_width=1d' \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H 'anthropic-version: 2023-06-01'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| starting_at | query | string | Yes | Time buckets that start on or after this RFC 3339 timestamp will be returned.... |
| limit | query | integer | No | Maximum number of time buckets to return in the response. |
| page | query | string | No | Optionally set to the `next_page` token from the previous response. |
| ending_at | query | string | No | Time buckets that end before this RFC 3339 timestamp will be returned. |
| group_by[] | query | string[] | No | Group by any subset of the available options. |
| bucket_width | query | string | No | Time granularity of the response data. |

## Response example
{"data":[{}],"has_more":true}

---
Need an API key? Get one at https://console.anthropic.com/settings/keys

GET

GET /v1/organizations/cost_report?beta=true — Claude API

Beta

Anthropic API key (required); https://api.anthropic.com

Claude API

Get Cost Report

Base URL: https://api.anthropic.com
Auth: x-api-key: <ANTHROPIC_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 301 tokens · Vary: Accept

Critical gotchas

Authentication uses the x-api-key header and requests also require an anthropic-version header.

The official OpenAPI URL is discovered from the SDK repository manifest and must remain under Anthropic's trusted Stainless storage prefix.

cURL

curl -X GET 'https://api.anthropic.com/v1/organizations/cost_report?beta=true&limit=7&page=example-page&starting_at=example-starting-at&ending_at=example-ending-at&group_by%5B%5D=example&bucket_width=1d' \  -H "x-api-key: $ANTHROPIC_API_KEY" \  -H 'anthropic-version: 2023-06-01'

Parameters

Name	In	Type	Required	Description
limit	query	integer	No	Maximum number of time buckets to return in the response.
page	query	string	No	Optionally set to the `next_page` token from the previous response.
starting_at	query	string	Yes	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	query	string	No	Time buckets that end before this RFC 3339 timestamp will be returned.
group_by[]	query	string[]	No	Group by any subset of the available options.
bucket_width	query	string	No	Time granularity of the response data.

Response 200 OK

{
  "data": [
    {
      "starting_at": "2026-09-03T00:00:00Z",
      "ending_at": "2026-09-03T00:00:00Z",
      "results": [
        {
          "currency": "string",
          "amount": "string",
          "workspace_id": "string",
          "description": "string",
          "cost_type": "code_execution",
          "context_window": "0-200k",
          "model": "string",
          "service_tier": "batch",
          "token_type": "cache_creation.ephemeral_1h_input_tokens",
          "inference_geo": "global"
        }
      ]
    }
  ],
  "has_more": true,
  "next_page": "string"
}

Get a free Claude API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.