---
title: "Get User Daily Activity Aggregated"
method: GET
path: "/user/daily/activity/aggregated"
tags: ["Budget & Spend Tracking", "Internal User management"]
---

# Get User Daily Activity Aggregated

`GET /user/daily/activity/aggregated`

Aggregated analytics for a user's daily activity without pagination.
Returns the same response shape as the paginated endpoint with page metadata set to single-page.

Reads daily spend records that only ever accumulate and are never affected by budget
resets. Their total can legitimately exceed the `spend` field returned by
`/v2/user/info`, which is a running budget counter that every budget reset sets back
to zero (or to the overage above `max_budget` when `budget_rollover` is enabled).

## Query parameters

- `start_date` string, nullable — Start date in YYYY-MM-DD format
- `end_date` string, nullable — End date in YYYY-MM-DD format
- `model` string, nullable — Filter by specific model
- `api_key` string, nullable — Filter by specific API key
- `user_id` string, nullable — Filter by specific user ID. Admins can filter by any user or omit for global view. Non-admins must provide their own user_id.
- `timezone` integer, nullable — Timezone offset in minutes from UTC (e.g., 480 for PST). Matches JavaScript's Date.getTimezoneOffset() convention.
- `include_current_utc_day` boolean — When the range ends on the caller's current local day, extend it to today's UTC bucket so spend written after the caller's local midnight (in UTC terms) is included. Requires the timezone parameter. Historical ranges are never extended.

## Response `200`

Successful Response

- SpendAnalyticsPaginatedResponse
  - `results` DailySpendData[], required
    - `date` string, date, required
    - `metrics` SpendMetrics, required
      - `spend` number
      - `flat_cost` number
      - `prompt_tokens` integer
      - `completion_tokens` integer
      - `cache_read_input_tokens` integer
      - `cache_creation_input_tokens` integer
      - `compression_saved_tokens` integer
      - `compression_savings_spend` number
      - `prompt_caching_savings_spend` number
      - `gateway_injected_caching_savings_spend` number
      - `autorouter_savings_spend` number
      - `total_tokens` integer
      - `successful_requests` integer
      - `failed_requests` integer
      - `api_requests` integer
    - `breakdown` BreakdownMetrics — Breakdown of spend by different dimensions
      - `mcp_servers` object
      - `models` object
      - `model_groups` object
      - `providers` object
      - `endpoints` object
      - `api_keys` object
      - `entities` object
  - `metadata` DailySpendMetadata
    - `total_spend` number
    - `total_flat_cost` number
    - `total_prompt_tokens` integer
    - `total_completion_tokens` integer
    - `total_tokens` integer
    - `total_api_requests` integer
    - `total_successful_requests` integer
    - `total_failed_requests` integer
    - `total_cache_read_input_tokens` integer
    - `total_cache_creation_input_tokens` integer
    - `total_compression_saved_tokens` integer
    - `total_compression_savings_spend` number
    - `total_prompt_caching_savings_spend` number
    - `total_gateway_injected_caching_savings_spend` number
    - `total_autorouter_savings_spend` number
    - `page` integer
    - `total_pages` integer
    - `has_more` boolean

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `082b5fabd909` — 100 info
  - added the new optional `query` request parameter `include_current_utc_day`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - added the optional property `metadata/total_autorouter_savings_spend` to the response with the `200` status
  - …96 more

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/user/daily/activity/aggregated/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/b694deb1e459?raw)