---
title: "Get Users Over Quota"
method: GET
path: "/admin/users_over_quota"
tags: ["accepts-api-key"]
---

# Get Users Over Quota

`GET /admin/users_over_quota`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/admin/users_over_quota`
- Auth: none declared

List the accounts storing more than their plan allows, worst first. Admin only.

Computed live across every account rather than read from the cached totals.
The cache fills in by use, so an account nobody has touched has no row in
it, and a report of who is over quota that quietly omits the dormant
accounts is worse than no report — those are exactly the ones that will be
surprised when the block turns on.

That makes this the expensive call: it walks the asset and rendition tables.
It is admin-only and paged for that reason.

Ordered by the overage in bytes, not by ratio: a free account 1 GB over
costs less than a paid one 400 GB over, however alarming the proportion.

## Query parameters

- `limit` integer: Maximum rows to return
- `offset` integer: Rows to skip, for paging

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- AdminOverQuotaResponse
  - `users` AdminOverQuotaUser[], required
    - `user_id` string, uuid, required
    - `email` string, required
    - `file_count` integer, required
    - `used_byte_size` integer, required
    - `used_gb` number, required
    - `quota_gb` integer, required
    - `over_by_byte_size` integer, required
    - `over_by_gb` number, required: What would have to go for them to come back under
    - `subscription_type` string, required: "Monthly", "Yearly", or "Free" for no active subscription
  - `returned_count` integer, required: How many rows this page holds. A full page means there may be more — ask again with a larger offset.

## Other responses

- `422`: Validation Error

---

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