--- title: Rate Limits url: https://platform.claude.com/docs/en/api/go/organization/rate_limits --- # Rate Limits ## List Organization Rate Limits `client.Organization.RateLimits.List(ctx, query) (*PageCursor[OrganizationRateLimit], error)` **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 - `query OrganizationRateLimitListParams` - `GroupType OrganizationRateLimitListParamsGroupType Optional` (query parameter) Filter by group type. - `const OrganizationRateLimitListParamsGroupTypeBatch OrganizationRateLimitListParamsGroupType = "batch"` - `const OrganizationRateLimitListParamsGroupTypeFiles OrganizationRateLimitListParamsGroupType = "files"` - `const OrganizationRateLimitListParamsGroupTypeModelGroup OrganizationRateLimitListParamsGroupType = "model_group"` - `const OrganizationRateLimitListParamsGroupTypeSkills OrganizationRateLimitListParamsGroupType = "skills"` - `const OrganizationRateLimitListParamsGroupTypeTokenCount OrganizationRateLimitListParamsGroupType = "token_count"` - `const OrganizationRateLimitListParamsGroupTypeWebSearch OrganizationRateLimitListParamsGroupType = "web_search"` - `Limit param.Opt[int64] Optional` (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 param.Opt[string] Optional` (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 param.Opt[string] Optional` (query parameter) Opaque cursor from a previous response's `next_page`. ### Returns - `type OrganizationRateLimit` - `Type RateLimit` Object type. Always `rate_limit` for organization rate-limit entries. default: rate_limit - `ID string` 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 OrganizationRateLimitGroupUnion` The rate-limit group this entry's limits apply to. Its `type` equals `group_type`. - `type OrganizationRateLimitModelGroup` - `Type ModelGroup` Always `model_group`: a family of models. default: model_group - `ID string` 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. - `DisplayName string` Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change. - `type OrganizationRateLimitBatchGroup` - `Type Batch` Always `batch`: the Message Batches API. default: batch - `ID string` 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. - `type OrganizationRateLimitTokenCountGroup` - `Type TokenCount` Always `token_count`: the Token Count API. default: token_count - `ID string` 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. - `type OrganizationRateLimitFilesGroup` - `Type Files` Always `files`: the Files API. default: files - `ID string` 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. - `type OrganizationRateLimitSkillsGroup` - `Type Skills` Always `skills`: the Skills API. default: skills - `ID string` 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. - `type OrganizationRateLimitWebSearchGroup` - `Type WebSearch` Always `web_search`: the Messages API web search tool. default: web_search - `ID string` 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 []OrganizationRateLimitValue` The limiter values that apply to this group. - `Type string` The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`). - `Value int64` The configured limit value for this limiter type. - `Models []string` Model names this entry's limits apply to, including aliases. `null` when `group_type` is not `"model_group"`. ### Example ```go package main import ( "context" "fmt" "github.com/anthropics/anthropic-sdk-go" "github.com/anthropics/anthropic-sdk-go/option" ) func main() { client := anthropic.NewClient( option.WithAPIKey("my-anthropic-api-key"), ) page, err := client.Organization.RateLimits.List(context.TODO(), anthropic.OrganizationRateLimitListParams{}) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` #### 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 ### Organization Rate Limit - `type OrganizationRateLimit` - `Type RateLimit` Object type. Always `rate_limit` for organization rate-limit entries. default: rate_limit - `ID string` 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 OrganizationRateLimitGroupUnion` The rate-limit group this entry's limits apply to. Its `type` equals `group_type`. - `type OrganizationRateLimitModelGroup` - `Type ModelGroup` Always `model_group`: a family of models. default: model_group - `ID string` 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. - `DisplayName string` Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change. - `type OrganizationRateLimitBatchGroup` - `Type Batch` Always `batch`: the Message Batches API. default: batch - `ID string` 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. - `type OrganizationRateLimitTokenCountGroup` - `Type TokenCount` Always `token_count`: the Token Count API. default: token_count - `ID string` 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. - `type OrganizationRateLimitFilesGroup` - `Type Files` Always `files`: the Files API. default: files - `ID string` 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. - `type OrganizationRateLimitSkillsGroup` - `Type Skills` Always `skills`: the Skills API. default: skills - `ID string` 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. - `type OrganizationRateLimitWebSearchGroup` - `Type WebSearch` Always `web_search`: the Messages API web search tool. default: web_search - `ID string` 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 []OrganizationRateLimitValue` The limiter values that apply to this group. - `Type string` The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`). - `Value int64` The configured limit value for this limiter type. - `Models []string` Model names this entry's limits apply to, including aliases. `null` when `group_type` is not `"model_group"`. ### Organization Rate Limit Batch Group - `type OrganizationRateLimitBatchGroup` - `Type Batch` Always `batch`: the Message Batches API. default: batch - `ID string` 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 - `type OrganizationRateLimitFilesGroup` - `Type Files` Always `files`: the Files API. default: files - `ID string` 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 - `type OrganizationRateLimitModelGroup` - `Type ModelGroup` Always `model_group`: a family of models. default: model_group - `ID string` 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. - `DisplayName string` Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change. ### Organization Rate Limit Skills Group - `type OrganizationRateLimitSkillsGroup` - `Type Skills` Always `skills`: the Skills API. default: skills - `ID string` 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 - `type OrganizationRateLimitTokenCountGroup` - `Type TokenCount` Always `token_count`: the Token Count API. default: token_count - `ID string` 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 - `type OrganizationRateLimitValue` - `Type string` The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`). - `Value int64` The configured limit value for this limiter type. ### Organization Rate Limit Web Search Group - `type OrganizationRateLimitWebSearchGroup` - `Type WebSearch` Always `web_search`: the Messages API web search tool. default: web_search - `ID string` 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.