---
title: "Returns a single user's usage-limits singleton (override, effective cap, usage, and whether they are over limit)."
method: GET
path: "/v1/accounts/{account_id}/users/{user_id}/usageLimits"
tags: ["gateway.openapi_Gateway"]
---

# Returns a single user's usage-limits singleton (override, effective cap, usage, and whether they are over limit).

`GET /v1/accounts/{account_id}/users/{user_id}/usageLimits`

## Request

- Base URL: `https://api.fireworks.ai`
- URL: `https://api.fireworks.ai/v1/accounts/{account_id}/users/{user_id}/usageLimits`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/docs/v1/accounts/:account_id/users/:user_id/usageLimits/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required
- `user_id` string, required

## Response `200`

A successful response.

- GatewayUserUsageLimits: UserUsageLimits is a single user's usage-limits singleton: their optional override cap, their resolved effective cap, their current-period usage, and whether (and until when) they are over their limit. There is exactly one per user. The override cap is stored; the effective cap, usage, enforcement mode, and exceeded_until are computed at read time.
  - `name` string
  - `limitOverride` TypeMoney: Represents an amount of money with its currency type.
    - `currencyCode` string: The three-letter currency code defined in ISO 4217.
    - `units` string, int64: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  - `effectiveLimit` TypeMoney: Represents an amount of money with its currency type.
    - `currencyCode` string: The three-letter currency code defined in ISO 4217.
    - `units` string, int64: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  - `used` TypeMoney: Represents an amount of money with its currency type.
    - `currencyCode` string: The three-letter currency code defined in ISO 4217.
    - `units` string, int64: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  - `enforcementMode` 'ENFORCEMENT_MODE_UNSPECIFIED' | 'DISABLED' | 'WARN' | 'BLOCK': EnforcementMode controls what happens when a user reaches their limit. - DISABLED: No tracking, no notifications, no enforcement. - WARN: Usage is tracked but never blocked. A safe stage before BLOCK. - BLOCK: Usage is tracked and the user is blocked at their limit until the period resets.
  - `exceededUntil` string, date-time: When set, the user is over their limit and blocked until this time (the end of the current consumption period). Unset when the user is not over limit. Computed at read time; not stored.
  - `updateTime` string, date-time: The time this user's override was last set or changed. Unset when the user has no override (they inherit the account default); it tracks the override row, not account-default changes.

## Changes

- **2026-10-16** `3bf245180173`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/accounts/:account_id/users/:user_id/usageLimits/get.md)

---

[API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) - [All operations](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/revisions/3bf245180173?raw)