---
title: "Lists every user's usage limits in the account (the roster: usage vs. effective cap and over-limit status per user)."
method: GET
path: "/v1/accounts/{account_id}/userUsageLimits"
tags: ["gateway.openapi_Gateway"]
---

# Lists every user's usage limits in the account (the roster: usage vs. effective cap and over-limit status per user).

`GET /v1/accounts/{account_id}/userUsageLimits`

## Request

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

## Path parameters

- `account_id` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

A successful response.

- GatewayListUserUsageLimitsResponse
  - `userUsageLimits` GatewayUserUsageLimits[]: One entry per user in the account (zero usage for users that incurred none this period), ordered by user id.
    - `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.
  - `nextPageToken` string: A token to pass as page_token to retrieve the next page. Empty when there are no further pages.

## 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/userUsageLimits/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)