Rate Limits API

Die Rate Limits API bietet programmatischen Zugriff auf die für deine Organisation und ihre Workspaces konfigurierten „rate limits" (Ratenlimits). Dies sind dieselben Informationen, die auf der Seite Limits in der Claude Console angezeigt werden.

Verwende diese API, um:

• Gateways und Proxys synchron zu halten: Lies deine aktuellen Limits beim Start und nach einem Zeitplan aus, anstatt Werte fest zu codieren, die abweichen, wenn Anthropic sie anpasst.
• Internes Alerting zu betreiben: Vergleiche Nutzungsdaten aus der Usage and Cost API mit deinen konfigurierten Limits.
• Workspace-Konfiguration zu prüfen: Verifiziere, dass Workspace-Overrides dem entsprechen, was deine Provisionierungs-Automatisierung erwartet.



Schnellstart

Liste die für deine Organisation konfigurierten Ratenlimits auf:

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Organisations-Ratenlimits

Der Endpunkt /v1/organizations/rate_limits gibt die auf Organisationsebene angewendeten Ratenlimits für die Messages API und ihre unterstützenden Ressourcen zurück. Limits für andere Produkte, wie Claude Managed Agents, sind nicht enthalten.



Wichtige Konzepte

• Ratenlimit-Gruppen: Jeder Eintrag in der Antwort repräsentiert eine Ratenlimit-Gruppe. Modell-Ratenlimits sind so gruppiert, dass mehrere Modellversionen sich einen einzigen Satz von Limits teilen, und andere Gruppen decken Ressourcen wie die Message Batches API, die Files API, die Token Counting API, Agent Skills und das Web-Such-Tool ab.
• group_type: Identifiziert, welche Kategorie von Limits der Eintrag abdeckt. Siehe Filtern nach Gruppentyp für die Liste der Werte.
• models-Liste: Für model_group-Einträge listet das Feld models jede Modell-ID und jeden Alias auf, die auf die Limits dieser Gruppe angerechnet werden. Verwende diese Liste, um nachzuschlagen, unter welche Gruppe ein beliebiger Modell-String fällt. Für andere Gruppentypen ist models null.
• limits-Liste: Jede Gruppe enthält eine Liste von {type, value}-Paaren. Das Feld type identifiziert den Limiter (wie requests_per_minute, input_tokens_per_minute oder output_tokens_per_minute) und value ist das konfigurierte Limit. Siehe Ratenlimits, um zu erfahren, wie jeder Limiter gemessen und durchgesetzt wird.

Vollständige Parameterdetails und Antwortschemata findest du in der Organization Rate Limits API-Referenz.



Alle Organisations-Ratenlimits auflisten

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "batch",
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}



Die Limits für ein bestimmtes Modell nachschlagen

Übergib eine beliebige Modell-ID oder einen Alias als model-Query-Parameter, um nur den Eintrag zurückzugeben, der sie enthält:

curl "https://api.anthropic.com/v1/organizations/rate_limits?model=claude-opus-5" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Wenn der Modell-String keiner Gruppe entspricht, gibt der Endpunkt einen 404-Fehler zurück. Der model-Parameter wird nur auf dem Organisations-Endpunkt unterstützt; der Workspace-Endpunkt akzeptiert ihn nicht.



Workspace-Ratenlimits

Der Endpunkt /v1/organizations/workspaces/{workspace_id}/rate_limits gibt die für einen einzelnen Workspace konfigurierten Ratenlimit-Overrides zurück.

Die Antwort enthält nur Overrides, sodass alles, was darin fehlt, von der Organisation geerbt wird:

• Eine Gruppe, die in data fehlt, hat überhaupt keinen Workspace-Override. Der Workspace erbt die Limits auf Organisationsebene für diese Gruppe (sie ist nicht unbegrenzt).
• Innerhalb einer vorhandenen Gruppe hat ein Limiter-Typ, der in limits[] fehlt, keinen Workspace-Override für diesen Limiter. Der Workspace erbt dafür den Organisationswert.
• Für jeden vorhandenen Limiter ist org_limit der Wert auf Organisationsebene für denselben Limiter, oder null, wenn die Organisation kein konfiguriertes Limit für diesen Limiter-Typ hat.

Vollständige Parameterdetails und Antwortschemata findest du in der Workspace Rate Limits API-Referenz.

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    },
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    }
  ],
  "next_page": null
}



Filtern nach Gruppentyp

Beide Endpunkte akzeptieren einen optionalen group_type-Query-Parameter, der die Antwort auf eine einzelne Kategorie beschränkt:

curl "https://api.anthropic.com/v1/organizations/rate_limits?group_type=batch" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Gültige Werte sind model_group, batch, token_count, files, skills und web_search.



Paginierung

Beide Endpunkte akzeptieren einen page-Query-Parameter und geben ein next_page-Feld zurück. Antworten bestehen derzeit immer aus einer einzigen Seite, daher ist next_page null. Iteriere über next_page, damit dein Client korrekt paginiert, ohne dass Änderungen nötig sind, wenn die Antwort wächst.



Häufig gestellte Fragen



Welche Modell-Strings erscheinen in der models-Liste?

Jede Modell-ID und jeder Alias, die auf die Gruppe angerechnet werden, einschließlich datierter IDs (wie claude-sonnet-4-5-20250929) und undatierter Aliase (wie claude-sonnet-4-5). Schlage einen beliebigen Modell-String nach, den du an die Messages API übergibst, und du findest ihn in genau einem model_group-Eintrag.



Was bedeutet es, wenn eine Gruppe in der Workspace-Antwort fehlt?

Der Workspace hat keinen Override für diese Gruppe und erbt das Limit auf Organisationsebene. Frage den Organisations-Endpunkt ab, um die geerbten Werte zu sehen.



Kann ich Ratenlimits mit dieser API aktualisieren?

Nein. Um Workspace-Ratenlimits festzulegen, öffne den Workspace in der Claude Console und verwende den Tab Limits.



Siehe auch

• Ratenlimits
• Admin API
• Admin API-Referenz
• Workspaces
• Usage and Cost API