Rate Limits API

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.

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.

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