---
title: "Get User Consumption"
method: GET
path: "/api/v1/admin/reporting/user-consumption"
tags: ["Admin APIs", "Reporting"]
---

# Get User Consumption

`GET /api/v1/admin/reporting/user-consumption`

## 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

- UserConsumptionRow[]
  - `rank` integer, required
  - `email` string, required
  - `short_name` string, required
  - `client_id` string
  - `business_name` string, required
  - `plan_tier` string
  - `is_distributor` boolean
  - `tokens` number
  - `mbs` number
  - `records` integer
  - `total_consumption` number
  - `num_server_requests` integer
  - `mcp_tokens` number
  - `mcp_tool_calls` integer

## 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)