Rate Limits API

Trust: ★★★☆☆ (0.90) · 0 validations · developer_reference

Published: 2026-05-10 · Source: crawler_authoritative

Tình huống

API documentation for querying organizational API rate limits programmatically, designed for administrators who need to sync gateways, power internal alerting, or audit workspace configurations.

Insight

The Rate Limits API provides programmatic access to rate limits configured for an organization and its workspaces, mirroring the information displayed on the Claude Console Limits page. Key concepts include: rate limit groups where each response entry represents one group (model versions share limits, other groups cover Message Batches API, Files API, Token Counting API, agent skills, and web search tool); group_type field identifies the category (model_group, batch, token_count, files, skills, web_search); the models list for model_group entries shows every model ID and alias counting against that group’s limits; the limits list contains {type, value} pairs where type identifies the limiter (requests_per_minute, input_tokens_per_minute, output_tokens_per_minute, enqueued_batch_requests) and value is the configured limit. The organization endpoint /v1/organizations/rate_limits returns organization-level limits for the Messages API only (excludes Claude Managed Agents and other products). The workspace endpoint /v1/organizations/workspaces/{workspace_id}/rate_limits returns workspace overrides; missing groups inherit org limits, missing limiter types within a group inherit org values, and org_limit field shows the inherited organization value. Both endpoints support group_type filtering and pagination via page parameter (currently single page with next_page always null).

Hành động

Authenticate with an Admin API key starting with sk-ant-admin… (differs from standard API keys). Make requests to https://api.anthropic.com/v1/organizations/rate_limits for org-level limits, or /v1/organizations/workspaces/{workspace_id}/rate_limits for workspace overrides. Required headers: anthropic-version: 2023-06-01 and x-api-key: $ANTHROPIC_ADMIN_KEY. Use model query parameter to filter to a specific model’s limits (returns 404 if no match, only supported on org endpoint). Use group_type query parameter to filter by category: model_group, batch, token_count, files, skills, or web_search. To retrieve workspace IDs, use the List Workspaces endpoint or Claude Console (note: default workspace cannot have overrides). The API is read-only; to set workspace rate limits, use the Claude Console workspace Limits tab.

Kết quả

Returns a JSON response with a data array containing rate limit group objects, each with type (rate_limit or workspace_rate_limit), group_type, models array (null for non-model groups), and limits array of {type, value} pairs. Workspace responses also include org_limit showing inherited organization values. next_page is null for single-page responses.

Điều kiện áp dụng

Requires Admin API key (sk-ant-admin… prefix). Admin API is unavailable for individual accounts. Organization-level endpoint only covers Messages API; excludes Claude Managed Agents and other products.

---

Nội dung gốc (Original)

Rate Limits API

Programmatically query your organization’s API rate limits with the Rate Limits API.

---

**The Admin API is unavailable for individual accounts.** To collaborate with teammates and add members, set up your organization in **Console → Settings → Organization**.

The Rate Limits API provides programmatic access to the rate limits configured for your organization and its workspaces. This is the same information shown on the Limits page in the Claude Console.

Use this API to:

• Keep gateways and proxies in sync: Read your current limits at startup and on a schedule instead of hardcoding values that drift when Anthropic adjusts them.
• Power internal alerting: Compare usage data from the Usage and Cost API against your configured limits.
• Audit workspace configuration: Verify that workspace overrides match what your provisioning automation expects.

**Admin API key required**

This API is part of the Admin API. These endpoints require an Admin API key (starting with sk-ant-admin...) that differs from standard API keys. Only organization members with the admin role can provision Admin API keys through the Claude Console.

Quick start

List the rate limits configured for your organization:

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Organization rate limits

The /v1/organizations/rate_limits endpoint returns the rate limits applied at the organization level for the Messages API and its supporting resources. Limits for other products, such as Claude Managed Agents, are not included.

Key concepts

• Rate limit groups: Each entry in the response represents one rate limit group. Model rate limits are grouped so that several model versions share a single set of limits, and other groups cover resources such as the Message Batches API, the Files API, the Token Counting API, agent skills, and the web search tool.
• group_type: Identifies which category of limits the entry covers. See Filtering by group type for the list of values.
• models list: For model_group entries, the models field lists every model ID and alias that counts against that group’s limits. Use this list to look up which group any model string falls under. For other group types, models is null.
• limits list: Each group carries a list of {type, value} pairs. The type field identifies the limiter (such as requests_per_minute, input_tokens_per_minute, or output_tokens_per_minute) and value is the configured limit. See Rate limits for how each limiter is measured and enforced.

For complete parameter details and response schemas, see the Organization Rate Limits API reference.

List all organization rate limits

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "batch",
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}

Look up the limits for a specific model

Pass any model ID or alias as the model query parameter to return only the entry that contains it:

curl "https://api.anthropic.com/v1/organizations/rate_limits?model=claude-opus-4-7" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

If the model string doesn’t match any group, the endpoint returns a 404 error. The model parameter is supported on the organization endpoint only; the workspace endpoint doesn’t accept it.

Workspace rate limits

The /v1/organizations/workspaces/{workspace_id}/rate_limits endpoint returns the rate limit overrides configured for a single workspace.

The response only includes overrides, so anything missing from it is inherited from the organization:

• A group that is absent from data has no workspace override at all. The workspace inherits the organization-level limits for that group (it is not unlimited).
• Within a group that is present, a limiter type that is absent from limits[] has no workspace override for that limiter. The workspace inherits the organization value for it.
• For each limiter that is present, org_limit is the organization-level value for the same limiter, or null if the organization has no configured limit for that limiter type.

For complete parameter details and response schemas, see the Workspace Rate Limits API reference.

To retrieve your organization's workspace IDs, use the [List Workspaces](/docs/en/api/admin/workspaces/list) endpoint, or find them in the [Claude Console](/settings/workspaces). The default workspace cannot have rate limit overrides, so it has no entry on this endpoint; use the organization endpoint to read its limits.

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    }
  ],
  "next_page": null
}

Filtering by group type

Both endpoints accept an optional group_type query parameter that restricts the response to a single category:

curl "https://api.anthropic.com/v1/organizations/rate_limits?group_type=batch" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Valid values are model_group, batch, token_count, files, skills, and web_search.

Pagination

Both endpoints accept a page query parameter and return a next_page field. Responses are currently always a single page, so next_page is null. Loop on next_page so your client paginates correctly without changes when the response grows.

Frequently asked questions

Which model strings appear in the models list?

Every model ID and alias that counts against the group, including dated IDs (such as claude-sonnet-4-5-20250929) and undated aliases (such as claude-sonnet-4-5). Look up any model string you pass to the Messages API and you’ll find it in exactly one model_group entry.

What does it mean if a group is missing from the workspace response?

The workspace has no override for that group and inherits the organization-level limit. Query the organization endpoint to see the inherited values.

Can I update rate limits with this API?

No. To set workspace rate limits, open the workspace in the Claude Console and use the Limits tab.

See also

• Rate limits
• Admin API
• Admin API reference
• Workspaces
• Usage and Cost API

Liên kết

• Nền tảng: Dev Framework · Anthropic
• Nguồn: https://platform.claude.com/docs/en/manage-claude/rate-limits-api.md

Xem thêm:

• Archive Session Thread API
• Strict tool use
• Create Message - Beta Messages API (Go)
• Claude Platform Release Notes Overview
• Compliance API - Chats Endpoints