---
title: "Admin Users Stats"
method: GET
path: "/admin/users/stats"
tags: ["admin"]
---

# Admin Users Stats

`GET /admin/users/stats`

## Request

- Base URL: `https://api.sumvid.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sumvid.app/admin/users/stats`
- Auth: HTTP bearer

Tier + lifetime request count for a batch of user ids, one entry per
requested id in the order requested -- ids we've never seen come back as
tier "free" / job_count 0 rather than being dropped, so the caller can
tell "idle user" from "unknown id" without guessing. Over the cap is a
400, never a silent truncation.

## Query parameters

- `ids` string, required

## Response `200`

Successful Response

- AdminUserStatsResponse
  - `users` AdminUserStat[], required
    - `user_id` string, required
    - `tier` string, required
    - `job_count` integer, required
    - `last_job_at` string, date-time, nullable
    - `credits` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sumvid/apis/summarize-vid.md) · [All operations](https://skmtc.dev/sumvid/apis/summarize-vid/llms.txt) · [OpenAPI document](https://skmtc.dev/sumvid/apis/summarize-vid/revisions/c03d66e07deb?raw)