---
title: "Returns the account-level usage-limits singleton (default per-user cap, enforcement, account-wide usage rollup)."
method: GET
path: "/v1/accounts/{account_id}/usageLimits"
tags: ["gateway.openapi_Gateway"]
---

# Returns the account-level usage-limits singleton (default per-user cap, enforcement, account-wide usage rollup).

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

## Request

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

## Path parameters

- `account_id` string, required

## Response `200`

A successful response.

- GatewayAccountUsageLimits: AccountUsageLimits is the account-level usage-limits singleton: the default per-user cap and enforcement mode applied to every user in the account, plus the account-wide current-period usage rollup. There is exactly one per account. The default cap and enforcement mode are stored; the usage rollup is computed at read time.
  - `name` string
  - `defaultUserLimit` 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.
  - `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.
  - `updateTime` string, date-time: The time the account usage limits (default cap / enforcement mode) were last updated. Unset until the account row is first written.

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