---
title: "GET /ai/limits"
method: GET
path: "/ai/limits"
tags: ["AI Gateway Limits"]
---

# GET /ai/limits

`GET /ai/limits`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/ai/limits`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Instance defaults and per-project overrides

- LimitsOverviewResponse
  - `built_in_max_requests_per_minute` integer, required: Requests per minute applied to a project when nothing is configured
  - `instance` LimitSettingsBody, required: Limits as stored for one scope. `null` inherits from the next level (project → instance → built-in); `0` means unlimited.
    - `max_cost_per_month_microcents` integer, nullable: Operator-funded spend per UTC calendar month, in microcents (1/10000 of a cent; 1 USD = 1,000,000 microcents)
    - `max_requests_per_minute` integer, nullable: Requests per rolling minute
  - `page` integer, required
  - `page_size` integer, required
  - `project_overrides` ProjectLimitOverride[], required: Projects that override the instance defaults
    - `limits` LimitSettingsBody, required: Limits as stored for one scope. `null` inherits from the next level (project → instance → built-in); `0` means unlimited.
      - `max_cost_per_month_microcents` integer, nullable: Operator-funded spend per UTC calendar month, in microcents (1/10000 of a cent; 1 USD = 1,000,000 microcents)
      - `max_requests_per_minute` integer, nullable: Requests per rolling minute
    - `project_id` integer, required
  - `total_project_overrides` integer, required: Total number of projects with overrides, across all pages

## Other responses

- `401`: Unauthorized
- `403`: Insufficient permissions

## Changes

> 81 revisions in range; 1 not diffed.

- **2026-10-16** `6e7c89bf1ab4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gotempsh/apis/temps/changes/ai/limits/get.md)

---

[API](https://skmtc.dev/gotempsh/apis/temps.md) · [All operations](https://skmtc.dev/gotempsh/apis/temps/llms.txt) · [OpenAPI document](https://skmtc.dev/gotempsh/apis/temps/revisions/ab6d5d19e930?raw)