# People who started using Claude, came back to it or kept using it

> Everyone who reported usage in the range is one of three: new when they were first seen inside it, continuing when they also reported usage in the range of the same length just before, and returning otherwise. At most five are named: up to three of the new and up to two of the returning, each kind taking the places the other leaves empty. The answer names people, so it is sent with Cache-Control: no-store.

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


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

Everyone who reported usage in the range is one of three: new when they were first seen inside it, continuing when they also reported usage in the range of the same length just before, and returning otherwise. At most five are named: up to three of the new and up to two of the returning, each kind taking the places the other leaves empty. The answer names people, so it is sent with Cache-Control: no-store.

### 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)
  - `active` (integer, required): People who reported usage in the range
  - `continuing` (integer, required): Those who also reported usage in the range of the same length just before
  - `new` (integer, required): Those first seen inside the range
  - `returning` (integer, required): Those seen before, and not in the range just before
  - `items` (array of object, required): At most five: up to three new people, the earliest first day first, then up to two returning people, the longest away first. When one kind has fewer, the other takes its places
    - `person` (string, required)
    - `status` (one of `new`, `returning`, required)
    - `first_seen` (date string, required): The first day usage or activity was reported for them
    - `away_days` (integer, nullable, required): For someone returning, the days from their last usage before the range to their first in it. Null for someone new, and for someone away longer than the 400 days looked back over
- `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)