---
title: "Get Per User Analytics"
method: GET
path: "/tag/user-agent/per-user-analytics"
tags: ["tag management", "user agent analytics"]
---

# Get Per User Analytics

`GET /tag/user-agent/per-user-analytics`

Get per-user analytics including successful requests, tokens, and spend by individual users.

This endpoint provides usage metrics broken down by individual users based on their
tag activity during the last 30 days ending on UTC today + 1 day.

Args:
    tag_filter: Optional filter to specific tag (legacy)
    tag_filters: Optional filter to multiple specific tags (takes precedence over tag_filter)
    page: Page number for pagination
    page_size: Number of items per page

Returns:
    PerUserAnalyticsResponse: Analytics data broken down by individual users for the last 30 days

## Query parameters

- `tag_filter` string, nullable — Filter by specific tag (optional)
- `tag_filters` string[], nullable — Filter by multiple specific tags (optional, takes precedence over tag_filter)
- `page` integer — Page number for pagination
- `page_size` integer — Items per page

## Response `200`

Successful Response

- PerUserAnalyticsResponse — Response for per-user analytics
  - `results` PerUserMetrics[], required
    - `user_id` string, required
    - `user_email` string, nullable
    - `user_agent` string, nullable
    - `successful_requests` integer
    - `failed_requests` integer
    - `total_requests` integer
    - `total_tokens` integer
    - `spend` number
  - `total_count` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)