Claude API

https://platform.claude.com/docs/en/api
Admin
The Claude API is a RESTful API that provides programmatic access to Claude models for...
Tokens:4,217,664
Snippets:25,635
Trust Score:9.9
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### GET /v1/organizations/plugins/{plugin_id}/installation_settings

Source: https://platform.claude.com/docs/en/api/beta/organization/plugins/installation_settings/list

Documentation for the GET endpoint that lists an organization-owned Plugin's installation settings.

```APIDOC
## GET /v1/organizations/plugins/{plugin_id}/installation_settings

### Description
List an organization-owned Plugin's installation settings, which say which members it is for, most recently created first. The list holds the Plugin's own organization-wide setting (absent while the Plugin inherits its marketplace's default) and each RBAC Group's own setting. A member-owned Plugin has shares instead, so this path returns 404 for one.

### Method
GET

### Endpoint
/v1/organizations/plugins/{plugin_id}/installation_settings

### Parameters
#### Path Parameters
- **plugin_id** (string) - Required - ID of the Plugin (prefixed `plugin_`).

#### Query Parameters
- **limit** (number) - Optional - Number of items to return per page. Defaults to `20`. Ranges from `1` to `100`. (default: 20, minimum: 1, maximum: 100)
- **organization_id** (string) - Optional - For a `read:org_audit` or `read:compliance_org_data` key created for all of a parent organization's linked organizations: a child organization of that parent to read instead of the organization the key was created in, given as the organization's UUID or its `org_`-prefixed ID. A value that is neither returns a 400; an organization that is not a child of the key's parent, or where the Plugins API is not available, returns a 404. Any other key may pass only its own organization's ID here; another organization returns a 404.
- **page** (string) - Optional - Optionally set to the `next_page` token from the previous response. (maxLength: 2048)
- **target_type** (string) - Optional - Only settings for this kind of target: `organization` (the organization-wide setting) or `rbac_group` (an RBAC Group's). Possible values: `"organization"`, `"rbac_group"`.

### Authentication
Accepted credentials: an Admin API key with the `read:plugins` or `read:org_audit` scope, or a Compliance Access Key with the `read:compliance_org_data` scope.

### Headers
- **anthropic-beta** (string) - Required - Must be `ce-plugins-2026-09-01`. A request without it returns `404`, exactly as if the endpoint did not exist.

### Response
#### Success Response (200)
Returns a list of installation settings, most recently created first. The list holds the Plugin's own organization-wide setting (absent while the Plugin inherits its marketplace's default) and each RBAC Group's own setting.

#### Error Responses
- **400** - Invalid `organization_id` value.
- **404** - Plugin not found, member-owned Plugin, organization not a child of the key's parent, organization where the Plugins API is not available, or missing beta header.

### Notes
The Plugins API is in beta and is available to Claude Enterprise organizations only. It is not available to Claude Platform (Claude Console) organizations, or to organizations with HIPAA readiness enabled.
```

--------------------------------

### GET /activities

Source: https://platform.claude.com/docs/en/api/http/compliance/activities

Retrieves a list of compliance activities. The response contains activity objects with fields such as actor, claude_artifact_id, comment_action, and timestamps.

```APIDOC
## GET /activities

### Description
Retrieves a list of compliance activities. Each activity includes details about the actor, the artifact, and the action performed.

### Method
GET

### Endpoint
/activities

### Response
#### Success Response (200)
- **activities** (array of Activity objects) - The list of compliance activities.

### Activity Object
- **actor** (object) - The actor who performed the activity. Can be one of the following types: APIActor, UserActor, UnauthenticatedUserActor, AnthropicActor, SystemActor, AdminAPIKeyActor, ServiceAccountActor, ScimDirectorySyncActor, or AttestedDeviceActor.
- **claude_artifact_id** (string) - The artifact's identifier.
- **comment_action** (string) - The action recorded. Possible values: "activate_thread", "create_thread", "deactivate_thread", "delete_thread", "edit_comment", "move_thread", "reopen", "reply", "resolve", "send_to_claude", "session_resolve", "unsend_to_claude", "unspecified".
- **id** (optional string) - Unique identifier for the activity, e.g. 'activity_abcd1234'.
- **actor_outside_organization** (optional boolean or null) - True when the actor belongs to a different organization than the artifact's owner.
- **claude_artifact_comment_id** (optional string or null) - The comment's identifier, present when the activity relates to a specific comment.
- **claude_artifact_comment_thread_id** (optional string or null) - The comment thread's identifier.
- **claude_artifact_version_id** (optional string or null) - The artifact version the comment activity applied to.
- **created_at** (optional string) - When this activity occurred. Format: date-time.
- **organization_id** (optional string or null) - Organization ID this activity is associated with.
- **organization_uuid** (optional string or null) - Organization UUID where the activity occurred.

### Actor Objects
#### APIActor
- **type** (optional string) - default: "api_actor"
- **api_key_id** (string) - The API key identifier.
- **ip_address** (string) - The IP address.
- **user_agent** (string) - The user agent.

#### UserActor
- **type** (optional string) - default: "user_actor"
- **email_address** (string) - Email address. Format: email.
- **ip_address** (string) - The IP address.
- **user_agent** (string) - The user agent.
- **user_id** (string) - The user identifier.

#### UnauthenticatedUserActor
- **type** (optional string) - default: "unauthenticated_user_actor"
- **ip_address** (string) - The IP address.
- **user_agent** (string) - The user agent.
- **unauthenticated_email_address** (optional string or null) - Email address. Format: email.

#### AnthropicActor
- **type** (optional string) - default: "anthropic_actor"
- **email_address** (optional string or null) - Email address. Format: email.

#### SystemActor
- **type** (optional string) - default: "system_actor"
- **service** (optional string or null) - Name of the automated process that performed the action.

#### AdminAPIKeyActor
- **type** (optional string) - default: "admin_api_key_actor"
- **admin_api_key_id** (string) - The admin API key identifier.
- **ip_address** (string) - The IP address.
- **user_agent** (string) - The user agent.

#### ServiceAccountActor
- **type** (optional string) - default: "service_account_actor"
- **ip_address** (string) - The IP address.
- **service_account_id** (string) - The service account identifier.
- **user_agent** (string) - The user agent.

#### ScimDirectorySyncActor
- **type** (optional string) - default: "scim_directory_sync_actor"
- **directory_id** (string) - The directory identifier.
- **workos_event_id** (string) - The WorkOS event identifier.

#### AttestedDeviceActor
- **type** (optional string) - default: "attested_device_actor"
- **external_client_id** (string) - The external client identifier.
- **kid_hash** (string) - The key identifier hash.
- **ip_address** (optional string or null) - The IP address.
- **user_agent** (optional string or null) - The user agent.

```

--------------------------------

### GET /v1/organizations/{organization_id}/compliance/activities

Source: https://platform.claude.com/docs/en/api/http/compliance/activities

Retrieves a list of compliance activities for an organization. The response includes activity objects with details about the actor, credential, link, profile, rule, and submitter.

```APIDOC
## GET /v1/organizations/{organization_id}/compliance/activities

### Description
Retrieves a list of compliance activities for an organization. The response includes activity objects with details about the actor, credential, link, profile, rule, and submitter.

### Method
GET

### Endpoint
/v1/organizations/{organization_id}/compliance/activities

### Parameters
#### Path Parameters
- **organization_id** (string) - Required - The organization ID.

### Response
#### Response Body
- **activities** (array of Activity objects) - The list of compliance activities.

#### Activity Object
- **type** (string) - The type of activity. Possible values include `ccr_agent_proxy_provisioning_link_enabled` and `ccr_agent_proxy_provisioning_link_submitted`.
- **actor** (object) - The actor who performed the activity. Can be one of the following types:
  - **APIActor** - An API key actor.
    - **type** (string) - `api_actor`
    - **api_key_id** (string) - The API key ID.
    - **ip_address** (string) - The IP address.
    - **user_agent** (string) - The user agent.
  - **UserActor** - A user actor.
    - **type** (string) - `user_actor`
    - **email_address** (string) - The user's email address.
    - **ip_address** (string) - The IP address.
    - **user_agent** (string) - The user agent.
    - **user_id** (string) - The user ID.
  - **UnauthenticatedUserActor** - An unauthenticated user actor.
    - **type** (string) - `unauthenticated_user_actor`
    - **ip_address** (string) - The IP address.
    - **user_agent** (string) - The user agent.
    - **unauthenticated_email_address** (string or null) - The unauthenticated email address.
  - **AnthropicActor** - An Anthropic actor.
    - **type** (string) - `anthropic_actor`
    - **email_address** (string or null) - The email address.
  - **SystemActor** - A system actor.
    - **type** (string) - `system_actor`
    - **service** (string or null) - The name of the automated process.
  - **AdminAPIKeyActor** - An admin API key actor.
    - **type** (string) - `admin_api_key_actor`
    - **admin_api_key_id** (string) - The admin API key ID.
    - **ip_address** (string) - The IP address.
    - **user_agent** (string) - The user agent.
  - **ServiceAccountActor** - A service account actor.
    - **type** (string) - `service_account_actor`
    - **ip_address** (string) - The IP address.
    - **service_account_id** (string) - The service account ID.
    - **user_agent** (string) - The user agent.
  - **ScimDirectorySyncActor** - A SCIM directory sync actor.
    - **type** (string) - `scim_directory_sync_actor`
    - **directory_id** (string) - The directory ID.
    - **workos_event_id** (string) - The WorkOS event ID.
    - **idp_connection_type** (string or null) - The IdP connection type.
  - **FederatedIdentityActor** - A federated identity actor.
    - **type** (string) - `federated_identity_actor`
    - **issuer** (string) - The issuer URL.
    - **subject** (string) - The subject.
    - **audience** (array of string) - The audience claims.
    - **ip_address** (string or null) - The IP address.
    - **user_agent** (string or null) - The user agent.
  - **AttestedDeviceActor** - An attested device actor.
    - **type** (string) - `attested_device_actor`
    - **external_client_id** (string) - The external client ID.
    - **kid_hash** (string) - The key ID hash.
    - **ip_address** (string or null) - The IP address.
    - **user_agent** (string or null) - The user agent.
- **credential_id** (string) - The credential the member submitted.
- **link_id** (string) - The provisioning link's identifier.
- **profile_id** (string) - The agent proxy profile the credential lived in.
- **rule_id** (string) - The disabled rule that was deleted alongside the credential.
- **submitted_by_user_id** (string) - The tagged account ID of the user who originally submitted the credential.
- **id** (string) - Unique identifier for the activity.
- **created_at** (string) - When this activity occurred.
- **organization_id** (string or null) - Organization ID this activity is associated with.
- **organization_uuid** (string or null) - Organization UUID where the activity occurred.

```

--------------------------------

### Response (200) for listing plugin installation settings

Source: https://platform.claude.com/docs/en/api/beta/organization/plugins/installation_settings/list

Example JSON response returned when the request succeeds. It contains an array of installation settings and a pagination token.

```json
{
  "data": [
    {
      "created_at": "2026-03-14T09:26:53.589793Z",
      "installation_preference": "required",
      "plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
      "target": {
        "type": "organization"
      },
      "type": "plugin_installation_setting",
          "updated_at": "2026-03-14T09:26:53.589793Z"
    }
  ],
  "next_page": "page_MjAyNi0wOS0xNlQxNDowNTowOVo"
}
```

--------------------------------

### GET /v1/organizations/usage_report/messages

Source: https://platform.claude.com/docs/en/api/http/beta/organization/usage_report/retrieve_messages

Documentation for the GET /v1/organizations/usage_report/messages endpoint, including request headers, a curl example, and the full 200 response schema with example JSON.

```APIDOC
## [GET] /v1/organizations/usage_report/messages

### Description
Retrieves a usage report for messages within an organization, providing token usage and related metrics for a specified time period.

### Method
GET

### Endpoint
/v1/organizations/usage_report/messages

### Parameters
#### Headers
- **anthropic-version** (string) - Required - The API version to use. Example: `2023-06-01`.
- **X-Api-Key** (string) - Required - The API key for authentication.

### Request Example
```bash
curl https://api.anthropic.com/v1/organizations/usage_report/messages \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"
```

### Response
#### Success Response (200)
- **data** (array) - List of usage report entries.
  - **ending_at** (string) - End timestamp of the reporting period (ISO 8601).
  - **results** (array) - List of usage details per account/key/model.
    - **account_id** (string) - The account identifier.
    - **api_key_id** (string) - The API key identifier.
    - **cache_creation** (object) - Cache creation token usage.
      - **ephemeral_1h_input_tokens** (integer) - Tokens used for 1-hour ephemeral cache creation.
      - **ephemeral_5m_input_tokens** (integer) - Tokens used for 5-minute ephemeral cache creation.
    - **cache_read_input_tokens** (integer) - Tokens read from cache.
    - **context_window** (string) - The context window size (e.g., "0-200k").
    - **inference_geo** (string) - The inference geographic region (e.g., "global").
    - **model** (string) - The model used (e.g., "claude-opus-5").
    - **output_tokens** (integer) - Number of output tokens.
    - **server_tool_use** (object) - Server tool usage metrics.
      - **web_search_requests** (integer) - Number of web search requests.
    - **service_account_id** (string) - The service account identifier.
    - **service_tier** (string) - The service tier (e.g., "standard").
    - **uncached_input_tokens** (integer) - Number of uncached input tokens.
    - **workspace_id** (string) - The workspace identifier.
  - **starting_at** (string) - Start timestamp of the reporting period (ISO 8601).
- **has_more** (boolean) - Indicates if there are more pages of results.
- **next_page** (string) - Pagination token for the next page.

#### Response Example
```json
{
  "data": [
    {
      "ending_at": "2025-08-02T00:00:00Z",
      "results": [
        {
          "account_id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
          "api_key_id": "apikey_01Rj2N8SVvo6BePZj99NhmiT",
          "cache_creation": {
            "ephemeral_1h_input_tokens": 0,
            "ephemeral_5m_input_tokens": 0
          },
          "cache_read_input_tokens": 200,
          "context_window": "0-200k",
          "inference_geo": "global",
          "model": "claude-opus-5",
          "output_tokens": 500,
          "server_tool_use": {
            "web_search_requests": 10
          },
          "service_account_id": "svac_01Hk3R9TWxq7CfQak00OiVw4",
          "service_tier": "standard",
          "uncached_input_tokens": 1500,
          "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
        }
      ],
      "starting_at": "2025-08-01T00:00:00Z"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}
```
```

--------------------------------

### GET /v1/deployments

Source: https://platform.claude.com/docs/en/api/beta/deployments

This code snippet documents the GET /v1/deployments endpoint, which lists all deployments. It includes the request headers, a curl example, and the full response schema with a JSON example.

```APIDOC
## GET /v1/deployments

### Description
Lists all deployments associated with the authenticated account. This endpoint returns a paginated list of deployment objects, each containing details such as the associated agent, schedule, status, and budget.

### Method
GET

### Endpoint
/v1/deployments

### Parameters
#### Headers
- **anthropic-version** (string) - Required - The API version to use. Must be set to `2023-06-01`.
- **anthropic-beta** (string) - Required - The beta header for the managed agents feature. Must be set to `managed-agents-2026-04-01`.
- **X-Api-Key** (string) - Required - Your Anthropic API key for authentication.

### Request Example
```bash
curl https://api.anthropic.com/v1/deployments \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: managed-agents-2026-04-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"
```

### Response
#### Success Response (200)
- **data** (array) - List of deployment objects.
  - **id** (string) - Unique identifier for the deployment.
  - **agent** (object) - The agent associated with the deployment.
    - **id** (string) - Agent identifier.
    - **type** (string) - Type of the agent, always "agent".
    - **version** (integer) - Version of the agent.
  - **archived_at** (string or null) - Timestamp when the deployment was archived, or null if not archived.
  - **created_at** (string) - Timestamp when the deployment was created.
  - **description** (string) - Description of the deployment.
  - **environment_id** (string) - Identifier of the environment.
  - **initial_events** (array) - Initial events for the deployment.
    - **content** (array) - Content of the event.
      - **text** (string) - Text content.
      - **type** (string) - Type of content, e.g., "text".
    - **type** (string) - Type of event, e.g., "user.message".
  - **metadata** (object) - Additional metadata.
  - **name** (string) - Name of the deployment.
  - **paused_reason** (object) - Reason for pausing, if paused.
    - **type** (string) - Type of pause reason, e.g., "manual".
  - **resources** (array) - Resources associated with the deployment.
    - **type** (string) - Type of resource, e.g., "github_repository".
    - **url** (string) - URL of the resource.
    - **checkout** (object) - Checkout information.
      - **name** (string) - Name of the branch or tag.
      - **type** (string) - Type of checkout, e.g., "branch".
    - **mount_path** (string) - Mount path for the resource.
  - **schedule** (object) - Schedule information.
    - **expression** (string) - Cron expression for the schedule.
    - **timezone** (string) - Timezone for the schedule.
    - **type** (string) - Type of schedule, e.g., "cron".
    - **last_run_at** (string) - Timestamp of the last run.
    - **upcoming_runs_at** (array) - List of upcoming run timestamps.
  - **status** (string) - Status of the deployment, e.g., "active".
  - **type** (string) - Type of the object, always "deployment".
  - **updated_at** (string) - Timestamp when the deployment was last updated.
  - **vault_ids** (array) - List of vault identifiers.
  - **budget** (object) - Budget information.
    - **max_list_cost** (object) - Maximum cost limit.
      - **amount** (string) - Amount as a string.
      - **currency** (string) - Currency code, e.g., "USD".
    - **type** (string) - Type of budget, e.g., "limit".
- **next_page** (string) - Pagination token for the next page of results.

#### Response Example
```json
{
  "data": [
    {
      "id": "depl_011CZkZcDH3vPqd7xnEfwTai",
      "agent": {
        "id": "agent_011CZkYpogX7uDKUyvBTophP",
        "type": "agent",
        "version": 1
      },
      "archived_at": null,
      "created_at": "2026-03-15T10:00:00Z",
      "description": "Compiles yesterday's orders into a report every weekday morning.",
      "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",
      "initial_events": [
        {
          "content": [
            {
              "text": "Compile yesterday's orders into report.md.",
              "type": "text"
            }
          ],
          "type": "user.message"
        }
      ],
      "metadata": {},
      "name": "Daily order report",
      "paused_reason": {
        "type": "manual"
      },
      "resources": [
        {
          "type": "github_repository",
          "url": "url",
          "checkout": {
            "name": "main",
            "type": "branch"
          },
          "mount_path": "mount_path"
        }
      ],
      "schedule": {
        "expression": "0 9 * * 1-5",
        "timezone": "America/Los_Angeles",
        "type": "cron",
        "last_run_at": "2026-03-16T16:00:09Z",
        "upcoming_runs_at": [
          "2026-03-17T16:00:00Z",
          "2026-03-18T16:00:00Z"
        ]
      },
      "status": "active",
      "type": "deployment",
      "updated_at": "2026-03-15T10:00:00Z",
      "vault_ids": [
        "vlt_011CZkZDLs7fYzm1hXNPeRjv"
      ],
      "budget": {
        "max_list_cost": {
          "amount": "2500",
          "currency": "USD"
        },
        "type": "limit"
      }
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}
```
```

--------------------------------

### POST /v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Source: https://platform.claude.com/docs/en/api/beta/organization/plugins/installation_settings/set

Documentation for the Set Plugin Installation Setting endpoint, including path parameters, authentication, headers, and error responses.

```APIDOC
## POST /v1/organizations/plugins/{plugin_id}/installation_settings/{target}

### Description
Set or change an organization-owned Plugin's installation setting for the whole organization or for one RBAC Group. Writing the value a target already holds of its own changes nothing. A member-owned Plugin has shares instead of installation settings, so this path returns 404 for one.

### Method
POST

### Endpoint
/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

### Parameters
#### Path Parameters
- **plugin_id** (string) - Required - ID of the Plugin (prefixed `plugin_`).
- **target** (string) - Required - The target whose setting is written: the literal `organization` for the Plugin's organization-wide setting, or an RBAC Group's ID (prefixed `rbac_group_`) for that group's own setting. Writing the `organization` target stops the Plugin from inheriting its marketplace's default, even when the value written equals that default.

### Authentication
- Admin API key with the `write:plugins` scope.

### Headers
- `anthropic-beta: ce-plugins-2026-09-01` (Required) - Every request must include this beta header. A request without it returns `404`, exactly as if the endpoint did not exist.

### Response
#### Success Response (200)
- No response body details provided.

#### Error Responses
- **404** - Returned for a member-owned Plugin (has shares instead of installation settings) or if the beta header is missing.
- **503** - Returned if several writes for the same Plugin arrive at the same time; the server handles them one after another and can answer some with `503`. The response carries `x-should-retry: true`, and the write is safe to repeat: wait a second or two, then send it again.
```

--------------------------------

### GET /v1/organizations/plugins/{plugin_id}/installation_settings

Source: https://platform.claude.com/docs/en/api/http/beta/organization/plugins

Lists installation settings for a Plugin. Returns an array of BetaPluginInstallationSetting objects and a next_page token for pagination.

```APIDOC
## GET /v1/organizations/plugins/{plugin_id}/installation_settings

### Description
List installation settings for a Plugin. Returns an array of BetaPluginInstallationSetting objects and a next_page token for pagination.

### Method
GET

### Endpoint
/v1/organizations/plugins/{plugin_id}/installation_settings

### Parameters
#### Path Parameters
- **plugin_id** (string) - Required - ID of the Plugin (prefixed `plugin_`).

### Request Example
```bash
curl https://api.anthropic.com/v1/organizations/plugins/$PLUGIN_ID/installation_settings \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: ce-plugins-2026-09-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"
```

### Response
#### Success Response (200)
- **data** (array of BetaPluginInstallationSetting) - List of installation settings.
  - **type** (string) - Always `plugin_installation_setting`.
  - **created_at** (string) - When the target was first given a setting for this Plugin. Format: date-time.
  - **installation_preference** (string) - The setting the target holds for this Plugin. One of `required`, `auto_install`, `available`, `not_available`; a value this API does not yet name is returned as stored.
  - **plugin_id** (string) - The Plugin's ID.
  - **target** (object) - Whose setting this is: `organization` or `rbac_group`; `organization_member` does not occur here.
    - **type** (string) - `organization` or `rbac_group`.
    - **rbac_group_id** (string) - The RBAC Group's ID (when type is `rbac_group`).
  - **updated_at** (string) - When its setting last changed. Format: date-time.
- **next_page** (string or null) - Token to provide as `page` in the subsequent request to retrieve the next page of data.

#### Response Example
```json
{
  "data": [
    {
      "created_at": "2026-03-14T09:26:53.589793Z",
      "installation_preference": "required",
      "plugin_id": "plugin_01JyHfbRkZvD1gW7oTqXc3Ne",
      "target": {
        "type": "organization"
      },
      "type": "plugin_installation_setting",
      "updated_at": "2026-03-14T09:26:53.589793Z"
    }
  ],
  "next_page": "page_MjAyNi0wOS0xNlQxNDowNTowOVo"
}
```
```

--------------------------------

### GET /v1/organizations/cost_report

Source: https://platform.claude.com/docs/en/api/http/beta

Documentation for the GET /v1/organizations/cost_report endpoint, including its response structure and example.

```APIDOC
## [GET] /v1/organizations/cost_report

### Description
Retrieves a cost report for the organization, returning cost data in time buckets. The response includes cost items with details such as amount, currency, model, and token type.

### Method
GET

### Endpoint
/v1/organizations/cost_report

### Parameters
#### Query Parameters
- **bucket_width** (string) - Required - The width of the time buckets for the cost report.
- **group_by[]** (string) - Optional - One or more fields to group the cost items by.
- **limit** (integer) - Optional - Maximum number of time buckets to return per page.
- **page** (string) - Optional - Opaque cursor for the next page, obtained from the `next_page` field of the previous response.

### Request Example
```bash
curl https://api.anthropic.com/v1/organizations/cost_report \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"
```

### Response
#### Success Response (200)
- **data** (array of object) - List of time buckets for this page, oldest first: one per `bucket_width` interval, including intervals with no costs (their `results` list is empty). A page holds at most `limit` buckets.
  - **ending_at** (string) - End of the time bucket (exclusive) in RFC 3339 format.
  - **results** (array of object) - List of cost items for this time bucket. There may be multiple items if one or more `group_by[]` parameters are specified.
    - **amount** (string) - Cost amount in lowest currency units (e.g. cents) as a decimal string. For example, `"123.45"` in `"USD"` represents `$1.23`.
    - **context_window** (BetaAnalyticsContextWindow or null) - Input context window used. `null` if not grouping by description or for non-token costs. Possible values: `"0-200k"`, `"200k-1M"`.
    - **cost_type** (string or null) - Type of cost. `null` if not grouping by description. Possible values: `"code_execution"`, `"session_usage"`, `"tokens"`, `"web_search"`.
    - **currency** (string) - Currency code for the cost amount. Currently always `"USD"`.
    - **description** (string or null) - Description of the cost item. `null` if not grouping by description.
    - **inference_geo** (BetaAnalyticsInferenceGeoFilter or null) - Inference geo used matching requests' `inference_geo` parameter if set, otherwise the workspace's `default_inference_geo`. For models that do not support specifying `inference_geo` the value is `"not_available"`. Always `null` if not grouping by inference geo. Possible values: `"global"`, `"not_available"`, `"us"`.
    - **model** (string or null) - Model name used. `null` if not grouping by description or for non-token costs.
    - **service_tier** (string or null) - Service tier used. `null` if not grouping by description or for non-token costs. Possible values: `"batch"`, `"standard"`.
    - **token_type** (BetaAnalyticsTokenType or null) - Type of token. `null` if not grouping by description or for non-token costs. Possible values: `"cache_creation.ephemeral_1h_input_tokens"`, `"cache_creation.ephemeral_5m_input_tokens"`, `"cache_read_input_tokens"`, `"output_tokens"`, `"uncached_input_tokens"`.
    - **workspace_id** (string or null) - ID of the Workspace this cost is associated with. `null` if not grouping by workspace or for the default workspace.
  - **starting_at** (string) - Start of the time bucket (inclusive) in RFC 3339 format.
- **has_more** (boolean) - Indicates if there are more results.
- **next_page** (string or null) - Opaque cursor for the next page, or `null` when `has_more` is false. Pass it as the `page` parameter in the next request.

#### Response Example
```json
{
  "data": [
    {
      "ending_at": "2025-08-02T00:00:00Z",
      "results": [
        {
          "amount": "123.78912",
          "context_window": "0-200k",
          "cost_type": "tokens",
          "currency": "USD",
          "description": "Claude Opus 5 Usage - Input Tokens",
          "inference_geo": "global",
          "model": "claude-opus-5",
          "service_tier": "standard",
          "token_type": "cache_creation.ephemeral_1h_input_tokens",
          "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
        }
      ],
      "starting_at": "2025-08-01T00:00:00Z"
    }
  ],
  "has_more": true,
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}
```
```
Tokens:
Raw