---
title: "Get Client Engagement"
method: GET
path: "/api/v1/admin/reporting/client-engagement"
tags: ["Admin APIs", "Reporting"]
---

# Get Client Engagement

`GET /api/v1/admin/reporting/client-engagement`

## Query parameters

- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `clients` string[], nullable
- `exclude_internal` boolean
- `plan_tiers` string, nullable

## Response `200`

Successful Response

- ClientEngagementResponse
  - `totals` ClientEngagementTotals, required
    - `total_clients` integer
    - `total_clients_by_plan_tier` object
    - `weekly_active_clients` number, nullable
    - `new_clients_count` integer
    - `new_clients_by_plan_tier` object
    - `total_server_requests` integer
    - `total_tokens` number
    - `total_primary_tokens` number
    - `total_promotional_tokens` number
    - `total_mbs` number
    - `total_records` integer
    - `total_s3_mbs` number
    - `total_polaris_s3_mbs` number
    - `total_polaris_s3_requests` integer
    - `total_mcp_tokens` number
    - `total_mcp_tool_calls` integer
  - `rows` ClientEngagementRow[], required
    - `short_name` string, required
    - `client_id` string
    - `business_name` string, required
    - `sector` string, required
    - `plan_tier` string
    - `is_new` boolean
    - `is_canceled` boolean
    - `is_expiring` boolean
    - `is_distributor` boolean
    - `all_engagement` integer
    - `tokens` number
    - `primary_tokens` number
    - `promotional_tokens` number
    - `mbs` number
    - `records` integer
    - `s3_mbs` number
    - `polaris_s3_mbs` number
    - `polaris_s3_requests` integer
    - `mcp_tokens` number
    - `mcp_tool_calls` integer
  - `sources` DataSourcesHealth
    - `platform` string
    - `s3` string
    - `polaris` string
  - `cached_at` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)