---
title: "Get Account Usage Limits"
method: GET
path: "/admin/billing/accounts/{user_id}/usage-limits"
tags: ["admin", "billing"]
---

# Get Account Usage Limits

`GET /admin/billing/accounts/{user_id}/usage-limits`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/admin/billing/accounts/{user_id}/usage-limits`
- Auth: OAuth 2
  - Password
  - Token URL: `api/login`

## Path parameters

- `user_id` string, required

## Response `200`

Successful Response

- AccountUsageLimitsResponse
  - `mode` 'off' | 'measure' | 'enforce', required
  - `applies` boolean, required
  - `day_budget` integer, required
  - `week_budget` integer, required
  - `day_tokens` integer, required
  - `week_tokens` integer, required
  - `day_ratio` number, required
  - `week_ratio` number, required
  - `day_calls` integer, required
  - `day_estimated_calls` integer, required
  - `week_calls` integer, required
  - `week_estimated_calls` integer, required
  - `copy_reviews_month` integer, required
  - `copy_review_limit` integer, required
  - `recommended_sessions_week` integer, required
  - `recommended_session_limit` integer, required
  - `library_blocks` integer, required
  - `unknown_origin_sessions_week` integer, required
  - `recent_events` UsageLimitEventResponse[], required
    - `feature` 'chat' | 'photo_correction' | 'session_start' | 'library_exercise' | 'copy_review' | 'auto_evaluation' | 'generation' | 'voice' | 'library' | 'recommended_session', required
    - `limit` 'meter' | 'cap', required
    - `window` 'day' | 'week' | 'month', required
    - `period` string, required
    - `mode` 'off' | 'measure' | 'enforce', required
    - `count` integer, required
    - `first_at` string, date-time, required
    - `last_at` string, date-time, required

## Other responses

- `404`: Resource not found
- `422`: Validation Error

## Changes

> 106 revisions in range; 1 not diffed.

- **2026-11-12** `0af74c49ba7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/billing/accounts/:user_id/usage-limits/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/de6afcc9656f?raw)
