# How Claude Code and Cowork usage is spread across people

> 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. Each person is counted in the band their usage value over the range falls in, and every band is answered, including one with nobody in it. top_decile and rest set the tenth of the people who used the most beside everyone else.

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


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

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. Each person is counted in the band their usage value over the range falls in, and every band is answered, including one with nobody in it. top_decile and rest set the tenth of the people who used the most beside everyone else.

### 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)
  - `people` (integer, required): People who reported usage in the range
  - `bands` (array of object, required): Every band, smallest first, including one with nobody in it
    - `floor` (integer, required): Smallest usage value in the band, in USD
    - `ceiling` (integer, nullable, required): Usage value the band stops short of, in USD. Null for the last band
    - `people` (integer, required): People whose usage value over the range is in the band
    - `usage_value` (number, required): Their usage value added up, in USD
  - `top_decile` (object, required): The tenth of the people with the largest usage value, a half rounding up, and at least one once anyone has reported usage
    - `people` (integer, required)
    - `usage_value` (number, required): Their usage value added up, in USD
    - `share` (number, required): Their part of everyone's usage value, 0 to 1
  - `rest` (object, required): Everyone else
    - `people` (integer, required)
    - `usage_value` (number, required): Their usage value added up, in USD
    - `share` (number, required): Their part of everyone's usage value, 0 to 1
- `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)