List Organization Rate Limits

$ ant beta:organization:rate-limits list

GET/v1/organizations/rate_limits

List Messages API rate limits for your organization.

Each entry corresponds to one rate-limit group (either a model family or an API-surface category such as the Files API or Message Batches) and contains the set of limiter values that apply to it.

This endpoint currently returns every matching entry in a single page regardless of limit; follow next_page so that clients keep working when pagination is enabled.

Parameters

--group-type: optional "batch" or "files" or "model_group" or 3 more

Filter by group type.

--limit: optional number

Maximum number of items to return per page. Ranges from 1 to 1000.

Accepted for request-shape compatibility and currently ignored: every entry is returned in a single page.

maximum1000

minimum1

--model: optional string

Filter to the single entry containing this model. Accepts full model names and aliases. Returns 404 if the model is not found or has no rate limits for this organization.

--page: optional string

Opaque cursor from a previous response's next_page.

Returns

BetaRateLimitListResponse: object{ data, next_page }

data: array of BetaOrganizationRateLimit { id, group_type, limits, 2 more }

Rate-limit entries for the organization, one per group.

id: string

Stable identifier for this rate-limit group within the organization.

group_type: "batch" or "files" or "model_group" or 3 more

The kind of rate-limit group this entry represents. model_group entries apply to a family of models (listed in models); other values apply to an API-surface category and have models set to null.

One of the following:

"batch"

"files"

"model_group"

"skills"

"token_count"

"web_search"

limits: array of BetaOrganizationRateLimitValue { type, value }

The limiter values that apply to this group.

type: string

The limiter type (for example, requests_per_minute or input_tokens_per_minute).

value: number

The configured limit value for this limiter type.

models: array of string

Model names this entry's limits apply to, including aliases. null when group_type is not "model_group".

type: "rate_limit"

Object type. Always rate_limit for organization rate-limit entries.

next_page: string

Token to provide in as page in the subsequent request to retrieve the next page of data.

List Organization Rate Limits

ant beta:organization:rate-limits list \
  --api-key my-anthropic-api-key

{
  "data": [
    {
      "id": "id",
      "group_type": "batch",
      "limits": [
        {
          "type": "type",
          "value": 0
        }
      ],
      "models": [
        "string"
      ],
      "type": "rate_limit"
    }
  ],
  "next_page": "next_page"
}

Returns Examples

{
  "data": [
    {
      "id": "id",
      "group_type": "batch",
      "limits": [
        {
          "type": "type",
          "value": 0
        }
      ],
      "models": [
        "string"
      ],
      "type": "rate_limit"
    }
  ],
  "next_page": "next_page"
}