---
title: "List Organization Rate Limits"
method: GET
path: "/v1/organizations/rate_limits?beta=true"
---

# List Organization Rate Limits

`GET /v1/organizations/rate_limits?beta=true`

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.

When `limit` is omitted, every matching entry is returned in a single
page; when `limit` truncates the result, follow `next_page` to fetch
the remaining entries.

## Query parameters

- `model` string, nullable — 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.
- `group_type` 'batch' | 'files' | 'model_group' | 'skills' | 'token_count' | 'web_search', nullable — Filter by group type.
- `limit` integer, nullable — 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`.
- `page` string, nullable — Opaque cursor from a previous response's `next_page`.

## Headers

- `x-api-key` string — Your unique Admin API key for authentication. This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the [Console](https://console.anthropic.com/settings/admin-keys).
- `anthropic-version` string — The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).

## Response `200`

Successful Response

- BetaRateLimitListResponse
  - `data` BetaRateLimit[], required — Rate-limit entries for the organization, one per group.
    - `group_type` 'batch' | 'files' | 'model_group' | 'skills' | 'token_count' | 'web_search', required — 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`.
    - `id` string, required — Stable identifier for this rate-limit group within the organization.
    - `limits` BetaRateLimitValue[], required — The limiter values that apply to this group.
      - `type` string, required — The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`).
      - `value` integer, required — The configured limit value for this limiter type.
    - `models` string[], nullable, required — Model names this entry's limits apply to, including aliases. `null` when `group_type` is not `"model_group"`.
    - `type` 'rate_limit', required — Object type. Always `rate_limit` for organization rate-limit entries.
  - `next_page` string, nullable, required — Opaque cursor for the next page of results, or `null` when no entries remain beyond this response.

## Other responses

- `400` — Invalid argument - The client specified an invalid argument
- `401` — Unauthenticated - The request does not have valid authentication credentials
- `403` — Permission denied - The caller does not have permission to execute the specified operation
- `404` — Not found - Some requested entity was not found
- `408` — Deadline exceeded - The deadline expired before the operation could complete
- `409` — Aborted - The operation was aborted due to concurrency issue
- `412` — Failed precondition - Operation was rejected because the system is not in required state
- `413` — Out of range - Operation was attempted past the valid range
- `429` — Resource exhausted - Some resource has been exhausted (rate limiting)
- `431` — Request header fields too large - Request metadata was too large
- `499` — Cancelled - The operation was cancelled by the client
- `500` — Internal - Internal server error
- `501` — Unimplemented - The operation is not implemented or supported
- `503` — Unavailable - The service is currently unavailable
- `504` — Deadline exceeded - Upstream service did not respond in time
- `529` — Overloaded - The service is temporarily overloaded

## Changes

- **2026-09-02** `4789294140a2` — 16 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - …12 more
- **2026-08-26** `942a11636c42` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/organizations/rate_limits?beta=true/get.md)

---

[API](https://skmtc.dev/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.dev/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anthropics/apis/anthropic-api/revisions/1bb7c7a0a4a9?raw)