# Claude Code and Cowork usage, in total and per day

> Usage is what Claude Code and Cowork reported about themselves, valued at API list price. It is not what the organization is billed, and it includes the current day. totals covers the range, with each person counted once. daily has one entry per day of the range, at zero on a day nobody used Claude.

Source: https://docs.levelfour.ai/api-reference/anthropic/get-providers-anthropic-usage


## GET /api/v1/providers/anthropic/usage

Usage is what Claude Code and Cowork reported about themselves, valued at API list price. It is not what the organization is billed, and it includes the current day. totals covers the range, with each person counted once. daily has one entry per day of the range, at zero on a day nobody used Claude.

### Authentication

Send `Authorization: Bearer <token>`.

### Parameters

- `start` (query, string, required): First day, ISO 8601 (YYYY-MM-DD or a datetime)
- `end` (query, string, required): Last day, ISO 8601 (YYYY-MM-DD or a datetime), included

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `data` (object, required)
  - `totals` (object, required)
    - `usage_value` (number, required)
    - `requests` (integer, required)
    - `active_people` (integer, required)
    - `input_tokens` (integer, required)
    - `output_tokens` (integer, required)
    - `cache_read_tokens` (integer, required)
    - `cache_creation_tokens` (integer, required)
  - `daily` (array of object, required)
    - `usage_value` (number, required)
    - `requests` (integer, required)
    - `active_people` (integer, required)
    - `input_tokens` (integer, required)
    - `output_tokens` (integer, required)
    - `cache_read_tokens` (integer, required)
    - `cache_creation_tokens` (integer, required)
    - `date` (date string, required)
- `timestamp` (string, required)

#### Errors

- `400`: Bad Request
- `401`: Authentication Error
- `403`: Authorization Error
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

Body of `400`, `401`, `403`, `404`, `409`, `422`, `429`, `500`:

- `success` (`false`, required)
- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (any)
- `timestamp` (date-time string, required)