--- title: Rate Limits url: https://platform.claude.com/docs/en/api/python/beta/organization/rate_limits --- # Rate Limits ## List Organization Rate Limits `beta.organization.rate_limits.list(**kwargs) -> SyncPageCursor[BetaOrganizationRateLimit]` **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 Message Batches API or the web search tool) 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. ### Parameters - `group_type: Optional[Literal["batch", "files", "model_group", 3 more]]` (query parameter) Filter by group type. - `"batch"` - `"files"` - `"model_group"` - `"skills"` - `"token_count"` - `"web_search"` - `limit: Optional[int]` (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`. minimum: 1, maximum: 1000 - `model: Optional[str]` (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[str]` (query parameter) Opaque cursor from a previous response's `next_page`. ### Returns - `class BetaOrganizationRateLimit` - `type: Literal["rate_limit"]` Object type. Always `rate_limit` for organization rate-limit entries. default: rate_limit - `id: str` 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: Group` The rate-limit group this entry's limits apply to. Its `type` equals `group_type`. - `class BetaOrganizationRateLimitModelGroup` - `type: Literal["model_group"]` Always `model_group`: a family of models. default: model_group - `id: str` 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: str` Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change. - `class BetaOrganizationRateLimitBatchGroup` - `type: Literal["batch"]` Always `batch`: the Message Batches API. default: batch - `id: str` 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. - `class BetaOrganizationRateLimitTokenCountGroup` - `type: Literal["token_count"]` Always `token_count`: the Token Count API. default: token_count - `id: str` 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. - `class BetaOrganizationRateLimitFilesGroup` - `type: Literal["files"]` Always `files`: the Files API. default: files - `id: str` 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. - `class BetaOrganizationRateLimitSkillsGroup` - `type: Literal["skills"]` Always `skills`: the Skills API. default: skills - `id: str` 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. - `class BetaOrganizationRateLimitWebSearchGroup` - `type: Literal["web_search"]` Always `web_search`: the Messages API web search tool. default: web_search - `id: str` 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: List[BetaOrganizationRateLimitValue]` The limiter values that apply to this group. - `type: str` The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`). - `value: int` The configured limit value for this limiter type. - `models: Optional[List[str]]` Model names this entry's limits apply to, including aliases. `null` when `group_type` is not `"model_group"`. - `group_type: Literal["batch", "files", "model_group", 3 more]` **Deprecated**: Use `group.type` instead. `group_type` is still returned and always equals `group.type`. 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`. - `"batch"` - `"files"` - `"model_group"` - `"skills"` - `"token_count"` - `"web_search"` ### Example ```python import os from anthropic import Anthropic client = Anthropic( api_key=os.environ.get( "ANTHROPIC_API_KEY" ), # This is the default and can be omitted ) page = client.beta.organization.rate_limits.list() page = page.data[0] print(page.id) ``` #### Response (200) ```json { "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" } ``` ## Domain types ### Beta Organization Rate Limit - `class BetaOrganizationRateLimit` - `type: Literal["rate_limit"]` Object type. Always `rate_limit` for organization rate-limit entries. default: rate_limit - `id: str` 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: Group` The rate-limit group this entry's limits apply to. Its `type` equals `group_type`. - `class BetaOrganizationRateLimitModelGroup` - `type: Literal["model_group"]` Always `model_group`: a family of models. default: model_group - `id: str` 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: str` Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change. - `class BetaOrganizationRateLimitBatchGroup` - `type: Literal["batch"]` Always `batch`: the Message Batches API. default: batch - `id: str` 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. - `class BetaOrganizationRateLimitTokenCountGroup` - `type: Literal["token_count"]` Always `token_count`: the Token Count API. default: token_count - `id: str` 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. - `class BetaOrganizationRateLimitFilesGroup` - `type: Literal["files"]` Always `files`: the Files API. default: files - `id: str` 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. - `class BetaOrganizationRateLimitSkillsGroup` - `type: Literal["skills"]` Always `skills`: the Skills API. default: skills - `id: str` 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. - `class BetaOrganizationRateLimitWebSearchGroup` - `type: Literal["web_search"]` Always `web_search`: the Messages API web search tool. default: web_search - `id: str` 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: List[BetaOrganizationRateLimitValue]` The limiter values that apply to this group. - `type: str` The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`). - `value: int` The configured limit value for this limiter type. - `models: Optional[List[str]]` Model names this entry's limits apply to, including aliases. `null` when `group_type` is not `"model_group"`. - `group_type: Literal["batch", "files", "model_group", 3 more]` **Deprecated**: Use `group.type` instead. `group_type` is still returned and always equals `group.type`. 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`. - `"batch"` - `"files"` - `"model_group"` - `"skills"` - `"token_count"` - `"web_search"` ### Beta Organization Rate Limit Batch Group - `class BetaOrganizationRateLimitBatchGroup` - `type: Literal["batch"]` Always `batch`: the Message Batches API. default: batch - `id: str` 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 - `class BetaOrganizationRateLimitFilesGroup` - `type: Literal["files"]` Always `files`: the Files API. default: files - `id: str` 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 Model Group - `class BetaOrganizationRateLimitModelGroup` - `type: Literal["model_group"]` Always `model_group`: a family of models. default: model_group - `id: str` 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: str` Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change. ### Beta Organization Rate Limit Skills Group - `class BetaOrganizationRateLimitSkillsGroup` - `type: Literal["skills"]` Always `skills`: the Skills API. default: skills - `id: str` 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 - `class BetaOrganizationRateLimitTokenCountGroup` - `type: Literal["token_count"]` Always `token_count`: the Token Count API. default: token_count - `id: str` 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 Value - `class BetaOrganizationRateLimitValue` - `type: str` The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`). - `value: int` The configured limit value for this limiter type. ### Beta Organization Rate Limit Web Search Group - `class BetaOrganizationRateLimitWebSearchGroup` - `type: Literal["web_search"]` Always `web_search`: the Messages API web search tool. default: web_search - `id: str` 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.