--- title: Rate Limits url: https://platform.claude.com/docs/en/api/php/organization/rate_limits --- # Rate Limits ## List Organization Rate Limits `$client->organization->rateLimits->list(?GroupType groupType, ?int limit, ?string model, ?string page): PageCursor` **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 - `groupType?:optional GroupType` (query parameter) Filter by group type. - `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`. - `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 - `class OrganizationRateLimit` - `"rate_limit" type` Object type. Always `rate_limit` for organization rate-limit entries. - `string id` Identifier of this rate-limit entry. It is stable within the organization and differs between organizations; the group's own identifier is `group.id`. Pass it as `rate_limit_id` to set a workspace's overrides for this group. - `Group group` The rate-limit group this entry's limits apply to. - `list limits` The limiter values that apply to this group. - `?list models` Model names this entry's limits apply to, including aliases. `null` when `group.type` is not `"model_group"`. The list covers the models your organization has access to, so it can differ between organizations. ### Example ```php organization->rateLimits->list( groupType: 'batch', limit: 1, model: 'model', page: 'page' ); var_dump($page); ``` #### Response (200) ```json { "data": [ { "id": "id", "group": { "id": "id", "display_name": "display_name", "type": "model_group" }, "limits": [ { "type": "type", "value": 0 } ], "models": [ "string" ], "type": "rate_limit" } ], "next_page": "next_page" } ``` ## Domain types ### Organization Rate Limit - `class OrganizationRateLimit` - `"rate_limit" type` Object type. Always `rate_limit` for organization rate-limit entries. - `string id` Identifier of this rate-limit entry. It is stable within the organization and differs between organizations; the group's own identifier is `group.id`. Pass it as `rate_limit_id` to set a workspace's overrides for this group. - `Group group` The rate-limit group this entry's limits apply to. - `list limits` The limiter values that apply to this group. - `?list models` Model names this entry's limits apply to, including aliases. `null` when `group.type` is not `"model_group"`. The list covers the models your organization has access to, so it can differ between organizations. ### Organization Rate Limit Batch Group - `class OrganizationRateLimitBatchGroup` - `"batch" type` Always `batch`: the Message Batches API. - `string id` 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. ### Organization Rate Limit Files Group - `class OrganizationRateLimitFilesGroup` - `"files" type` Always `files`: the Files API. - `string id` 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. ### Organization Rate Limit Model Group - `class OrganizationRateLimitModelGroup` - `"model_group" type` Always `model_group`: a family of models. - `string id` 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. - `string displayName` Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change. ### Organization Rate Limit Skills Group - `class OrganizationRateLimitSkillsGroup` - `"skills" type` Always `skills`: the Skills API. - `string id` 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. ### Organization Rate Limit Token Count Group - `class OrganizationRateLimitTokenCountGroup` - `"token_count" type` Always `token_count`: the Token Count API. - `string id` 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. ### Organization Rate Limit Value - `class OrganizationRateLimitValue` - `string type` The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`). - `int value` The configured limit value for this limiter type. ### Organization Rate Limit Web Search Group - `class OrganizationRateLimitWebSearchGroup` - `"web_search" type` Always `web_search`: the Messages API web search tool. - `string id` 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.