Claude Platform Docs

列出组织速率限制

$ ant beta:organization:rate-limits list
GET/v1/organizations/rate_limits

列出您组织的 Messages API "rate limit"（速率限制）。

每个条目对应一个速率限制组（可以是一个模型系列，也可以是一个 API 功能类别，例如 Message Batches API 或网络搜索工具），并包含适用于该组的一组限制器值。

省略 limit 时，所有匹配的条目将在单个页面中返回；当 limit 截断结果时，请通过 next_page 获取剩余条目。

Parameters
--group-type: optional "batch" or "files" or "model_group" or 3 more⁠Query parameter

Filter by group type.

--limit: optional number⁠Query parameter

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

When omitted, every remaining entry is returned in a single page and next_page is null.

minimum1
maximum1000
--model: optional string⁠Query parameter

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⁠Query parameter

Opaque cursor from a previous response's next_page.

Returns
BetaRateLimitListResponse: object{ data, next_page }
data: array of BetaOrganizationRateLimit { type: "rate_limit", id, group, 3 more }

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

type: "rate_limit"

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

id: string

Identifier of this rate-limit entry. It is stable within the organization and differs between organizations; the group's own identifier is group.id.

group: BetaOrganizationRateLimitModelGroup or BetaOrganizationRateLimitBatchGroup or BetaOrganizationRateLimitTokenCountGroup or 3 more

The rate-limit group this entry's limits apply to. Its type equals group_type.

One of the following:
beta_organization_rate_limit_model_group: object{ type: "model_group", id, display_name }
type: "model_group"

Always model_group: a family of models.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

display_name: string

Human-readable name of the model group (for example, Claude Sonnet 4.x). For display only; it may change.

beta_organization_rate_limit_batch_group: object{ type: "batch", id }
type: "batch"

Always batch: the Message Batches API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_token_count_group: object{ type: "token_count", id }
type: "token_count"

Always token_count: the Token Count API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_files_group: object{ type: "files", id }
type: "files"

Always files: the Files API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_skills_group: object{ type: "skills", id }
type: "skills"

Always skills: the Skills API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_web_search_group: object{ type: "web_search", id }
type: "web_search"

Always web_search: the Messages API web search tool.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

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".

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

Deprecated: use group.type instead. 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. Always equal to group.type.

Use `group.type` instead. `group_type` is still returned and always equals `group.type`.
One of the following:
"batch"
"files"
"model_group"
"skills"
"token_count"
"web_search"
next_page: string

Opaque cursor for the next page of results, or null when no entries remain beyond this response.

列出组织速率限制
ant beta:organization:rate-limits list \
  --api-key my-anthropic-api-key
Returns Examples
Response 200
{
  "data": [
    {
      "id": "id",
      "group": {
        "id": "id",
        "display_name": "display_name",
        "type": "model_group"
      },
      "group_type": "batch",
      "limits": [
        {
          "type": "type",
          "value": 0
        }
      ],
      "models": [
        "string"
      ],
      "type": "rate_limit"
    }
  ],
  "next_page": "next_page"
}