Claude Platform Docs

Lister les limites de débit de l'organisation

GET/v1/organizations/rate_limits

Liste les limites de débit de l'API Messages pour votre organisation.

Chaque entrée correspond à un groupe de limites de débit (soit une famille de modèles, soit une catégorie de surface d'API telle que l'API Files ou Message Batches) et contient l'ensemble des valeurs de limiteur qui s'y appliquent.

Lorsque limit est omis, toutes les entrées correspondantes sont renvoyées dans une seule page ; lorsque limit tronque le résultat, suivez next_page pour récupérer les entrées restantes.

Query parameters
group_type: optional "batch" or "files" or "model_group" or 3 more

Filter by group type.

One of the following:
"batch"
"files"
"model_group"
"skills"
"token_count"
"web_search"
limit: optional number

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.

minimum1
maximum1000
model: optional string

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

Opaque cursor from a previous response's next_page.

Returns
data: array of OrganizationRateLimit { type: "rate_limit", id, group, 3 more }

Rate-limit entries for the organization, one per group.

type: "rate_limit"

Object type. Always rate_limit for organization rate-limit entries.

defaultrate_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: OrganizationRateLimitModelGroup or OrganizationRateLimitBatchGroup or OrganizationRateLimitTokenCountGroup or 3 more

The rate-limit group this entry's limits apply to. Its type equals group_type.

One of the following:
OrganizationRateLimitModelGroup object{ type: "model_group", id, display_name }
type: "model_group"

Always model_group: a family of models.

defaultmodel_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.

display_name: string

Human-readable name of the model group (for example, Claude Sonnet 4.x). For display only; it may change.

OrganizationRateLimitBatchGroup object{ type: "batch", id }
type: "batch"

Always batch: the Message Batches API.

defaultbatch
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.

OrganizationRateLimitTokenCountGroup object{ type: "token_count", id }
type: "token_count"

Always token_count: the Token Count API.

defaulttoken_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.

OrganizationRateLimitFilesGroup object{ type: "files", id }
type: "files"

Always files: the Files API.

defaultfiles
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.

OrganizationRateLimitSkillsGroup object{ type: "skills", id }
type: "skills"

Always skills: the Skills API.

defaultskills
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.

OrganizationRateLimitWebSearchGroup object{ type: "web_search", id }
type: "web_search"

Always web_search: the Messages API web search tool.

defaultweb_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: array of OrganizationRateLimitValue { type, value }

The limiter values that apply to this group.

type: string

The limiter type (for example, requests_per_minute or input_tokens_per_minute).

value: number

The configured limit value for this limiter type.

models: array of string or null

Model names this entry's limits apply to, including aliases. null when group_type is not "model_group".

group_type: "batch" or "files" or "model_group" or 3 more⁠Deprecated

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.

Use `group.type` instead. `group_type` is still returned and always equals `group.type`.
One of the following:
"batch"
"files"
"model_group"
"skills"
"token_count"
"web_search"
next_page: string or null

Opaque cursor for the next page of results, or null when no entries remain beyond this response.

Lister les limites de débit de l'organisation
curl https://api.anthropic.com/v1/organizations/rate_limits \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"
Returns Examples
Response 200
{
  "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"
}