Spend Limits API

Mit der Spend Limits API kannst du ein Ausgabenlimit für jedes Claude Enterprise-Mitglied festlegen, sehen, woher das Ausgabenlimit jedes Mitglieds geerbt wird, und Anfragen von Mitgliedern nach einem höheren Limit prüfen oder bearbeiten.

Für nutzerbezogene und zeitlich gruppierte Nutzungs- und Kosten-Berichte siehe Analytics APIs.



Überblick

Die API stellt acht Endpunkte über zwei Ressourcen bereit:

Verwende die Ausgabenlimit-Endpunkte, um die Frage zu beantworten: „Welches Ausgabenlimit gilt für jedes Mitglied, woher stammt es, und wie nah sind sie daran?" – und um eine nutzerspezifische Überschreibung zu setzen. Verwende die Endpunkte für Anfragen zur Erhöhung des Ausgabenlimits, um die Warteschlange der von Mitgliedern eingereichten Anfragen abzuarbeiten.



Voraussetzungen

• Deine Organisation muss einen Claude Enterprise-Plan haben.
• Nutzungsguthaben (Usage Credits) müssen für deine Organisation aktiviert sein. Dein Primary Owner kann sie in den Abrechnungseinstellungen von claude.ai aktivieren.



Schnellstart

Liste das effektive monatliche Ausgabenlimit und die bisherigen Ausgaben im Zeitraum für jedes Mitglied auf:

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Zentrale Konzepte



Die Ausgabenlimit-Hierarchie

Ein effektives Ausgabenlimit gilt für die Ausgaben jedes Mitglieds und wird aus einer Hierarchie von Scope-Ebenen aufgelöst. Wenn ein Mitglied keine nutzerspezifische Überschreibung hat, erbt es das Ausgabenlimit, das für seine Gruppe konfiguriert ist (falls deine Organisation gruppenbasierte Limits verwendet), für seine Seat-Tier oder den organisationsweiten Standardwert. Ein Gruppen-Ausgabenlimit ist ein Standardwert pro Mitglied: Jedes Mitglied, das es erbt, wird an seinen eigenen Ausgaben gemessen, nicht an einem gemeinsamen Gruppenbudget.

Das Auslesen von GET /v1/organizations/spend_limits/effective liefert jedes aktuelle Mitglied mit seinem aufgelösten effektiven Ausgabenlimit, der Quelle, aus der dieses Limit aufgelöst wurde (source), und seinen bisherigen Ausgaben im Zeitraum. Das Setzen einer nutzerspezifischen Überschreibung mit POST /v1/organizations/spend_limits fixiert ein Mitglied auf ein bestimmtes Ausgabenlimit, unabhängig davon, was es sonst erben würde. Das Löschen der Überschreibung setzt das Mitglied auf das geerbte Ausgabenlimit zurück (oder lässt es unbegrenzt, falls keines existiert).

Das Feld source in der Zeile jedes Mitglieds gibt an, von welcher Ebene sein Ausgabenlimit aufgelöst wurde: user (eine nutzerspezifische Überschreibung), seat_tier, rbac_group oder organization. Behandle Scope-Typen als offene Menge; falle bei unbekannten Werten durch, anstatt fehlzuschlagen.



Zeitraum

period ist das wiederkehrende Zeitfenster, über das das Ausgabenlimit durchgesetzt wird und die Ausgaben zurückgesetzt werden. Ein Ausgabenlimit wird durch sein (scope, period)-Paar identifiziert. Derzeit ist monthly der einzige unterstützte Zeitraum; monatliche Ausgaben werden am Ersten jedes Kalendermonats um 00



Beträge und Währung

Alle Geldbeträge sind Strings in Untereinheiten der Abrechnungswährung der Organisation (Cent, für USD). Zum Beispiel steht "50000" für 500,00 USD. Parse den Wert als Dezimalzahl und teile durch 100, um Dollar anzuzeigen; vermeide binäre Gleitkommazahlen für große Werte.

amount ist nullable. In der effektiven Zeile eines Mitglieds bedeutet null unbegrenzt (kein Ausgabenlimit), und "0" bedeutet, dass das Mitglied Claude nicht über die im Plan enthaltene Nutzung hinaus verwenden kann. In einer konfigurierten Ausgabenlimit-Zeile (wie von GET /v1/organizations/spend_limits/{id} zurückgegeben) bedeutet null nur, dass kein numerisches Ausgabenlimit gesetzt ist; lies die effektive Zeile des Mitglieds, um zwischen unbegrenzt und nur-enthaltene-Nutzung zu unterscheiden.

period_to_date_spend sind die Ausgaben des Mitglieds seit Beginn des aktuellen period, im selben Untereinheiten-Format; der Wert kann einen Nachkommateil enthalten (zum Beispiel "41280.125"). Er kann als "0" angezeigt werden, wenn die Ausgabenablesung vorübergehend nicht verfügbar ist; behandle ihn als informativ, nicht als transaktional.



Lebenszyklus einer Erhöhungsanfrage

Eine Anfrage zur Erhöhung des Ausgabenlimits wird erstellt, wenn ein Mitglied in claude.ai auf Request more usage klickt. Anfragen werden nicht über diese API erstellt. Der status einer Anfrage ist einer der folgenden:

Sowohl approved als auch denied sind Endzustände. Ein Mitglied hat höchstens eine pending-Anfrage gleichzeitig.

Das Genehmigen mit POST /v1/organizations/spend_limit_increase_requests/{id}/approve schreibt dieselbe nutzerspezifische Ausgabenlimit-Zeile, die auch POST /v1/organizations/spend_limits schreibt. Das direkte Setzen eines Ausgabenlimits ändert den Status einer ausstehenden Anfrage nicht; verwende den Approve-Endpunkt, um eine Anfrage abzuschließen.

Standardmäßig sendet Anthropic dem Mitglied eine E-Mail, wenn seine Anfrage genehmigt oder abgelehnt wird. Übergib suppress_notification: true beim Genehmigen oder Ablehnen, um diese E-Mail zu unterdrücken (zum Beispiel, wenn dein eigenes System das Mitglied benachrichtigt).



Ratenlimit

Alle acht Endpunkte teilen sich ein gemeinsames Limit von 60 Anfragen pro Minute pro Organisation. Anfragen über dem Limit geben 429 Too Many Requests zurück.



Paginierung

GET /v1/organizations/spend_limits/effective und GET /v1/organizations/spend_limit_increase_requests sind mit einem opaken Cursor paginiert. Die erste Anfrage liefert bis zu limit Zeilen plus einen next_page-Cursor; übergib diesen Cursor unverändert als page-Parameter bei der nächsten Anfrage und wiederhole dies, bis next_page null ist.

Ändere die Query-Parameter nicht mitten in der Sequenz. Cursor sind an die Filter gebunden, die sie erzeugt haben. Wenn du user_ids[], period[], status[] oder actor_ids[] änderst und einen alten Cursor übergibst, erhältst du einen 400-Fehler mit „cursor does not match current query parameters". Starte stattdessen eine neue Sequenz von der ersten Seite.



Serialisierung von Listenparametern

Listenparameter verwenden die Klammer-Notation: Wiederhole den Parameternamen mit [] für jeden Wert.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq



Fehlerantworten

Fehlerantworten folgen dem Standardformat, das unter Fehler dokumentiert ist. Gib die request_id aus dem Response-Body an, wenn du den Support kontaktierst.



Ausgabenlimits



Das effektive Ausgabenlimit jedes Mitglieds auflisten

GET /v1/organizations/spend_limits/effective liefert eine Zeile pro aktuellem Mitglied, die das effektive Ausgabenlimit jedes Mitglieds, dessen source in der Scope-Hierarchie und dessen period_to_date_spend widerspiegelt. Erfordert den Scope read:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Effektive Ausgabenlimits auflisten in der API-Referenz.

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
      "actor": {
        "type": "user_actor",
        "user_id": "user_01AbCdEfGh",
        "name": "Jane Smith",
        "email_address": "[email protected]",
        "deleted": false
      },
      "amount": "50000",
      "currency": "USD",
      "period": "monthly",
      "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
      "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
      "period_to_date_spend": "31402.5"
    }
  ],
  "next_page": "page_..."
}



Ein einzelnes Ausgabenlimit abrufen

GET /v1/organizations/spend_limits/{spend_limit_id} liefert ein konfiguriertes Ausgabenlimit anhand der ID. Verwende dies, um die Zeile zu inspizieren, auf die ein spend_limit_id-Feld verwiesen hat. Erfordert den Scope read:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Ein Ausgabenlimit abrufen in der API-Referenz.

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Eine nutzerspezifische Überschreibung setzen

POST /v1/organizations/spend_limits setzt eine nutzerspezifische Ausgabenlimit-Überschreibung. Dies ist ein Upsert mit dem Schlüssel (scope, period): Das Setzen eines Limits für einen Nutzer und Zeitraum, für den bereits eines existiert, überschreibt es an Ort und Stelle. Dieser Endpunkt akzeptiert nur scope.type: "user"; Standardwerte auf Seat-Tier-, Gruppen- und Organisationsebene werden in den claude.ai-Einstellungen konfiguriert. Erfordert den Scope write:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Ein Ausgabenlimit erstellen in der API-Referenz.

curl --request POST "https://api.anthropic.com/v1/organizations/spend_limits" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'

{
  "type": "spend_limit",
  "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
  "created_at": "2026-05-11T10:02:44Z",
  "updated_at": "2026-05-11T10:02:44Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "75000",
  "currency": "USD",
  "period": "monthly"
}



Eine nutzerspezifische Überschreibung entfernen

DELETE /v1/organizations/spend_limits/{spend_limit_id} entfernt eine nutzerspezifische Überschreibung, wonach das Mitglied auf einen geerbten Seat-Tier-, Gruppen- oder Organisationsstandardwert zurückfällt. Zeilen auf Seat-Tier-, Gruppen- und Organisationsebene können über diesen Endpunkt nicht gelöscht werden. Erfordert den Scope write:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Ein Ausgabenlimit löschen in der API-Referenz.

curl --request DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Anfragen zur Erhöhung des Ausgabenlimits



Erhöhungsanfragen auflisten

GET /v1/organizations/spend_limit_increase_requests listet Anfragen auf, die neuesten zuerst. Filtere nach status[] (pending, approved, denied) und actor_ids[]. Die Liste schließt Anfragen aus, deren Antragsteller kein Mitglied der Organisation mehr ist. Erfordert den Scope read:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Anfragen zur Erhöhung des Ausgabenlimits auflisten in der API-Referenz.

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Jede ausstehende Anfrage enthält eine aktuelle spend_summary, die das aktuelle effektive Ausgabenlimit und die bisherigen Ausgaben des Antragstellers im Zeitraum zeigt – genug, um ohne separate Abfrage zu entscheiden.



Eine einzelne Erhöhungsanfrage abrufen

GET /v1/organizations/spend_limit_increase_requests/{id} liefert eine Anfrage anhand der ID. Erfordert den Scope read:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Eine Anfrage zur Erhöhung des Ausgabenlimits abrufen in der API-Referenz.

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Eine Erhöhungsanfrage genehmigen

POST /v1/organizations/spend_limit_increase_requests/{id}/approve genehmigt eine ausstehende Anfrage: Es schreibt ein nutzerspezifisches Ausgabenlimit mit dem vom Admin angegebenen amount für den Antragsteller und setzt die Anfrage auf approved. Die Anfrage enthält keinen angefragten Betrag; du gibst das neue Ausgabenlimit bei der Genehmigung an. Erfordert den Scope write:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Eine Anfrage zur Erhöhung des Ausgabenlimits genehmigen in der API-Referenz.

curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"amount": "75000", "suppress_notification": true}'



Eine Erhöhungsanfrage ablehnen

POST /v1/organizations/spend_limit_increase_requests/{id}/deny lehnt eine ausstehende Anfrage ab. Idempotent bei denied: Das Ablehnen einer bereits abgelehnten Anfrage liefert 200 mit der bestehenden Ressource zurück. Der Endpunkt weist einen Versuch zurück, eine bereits genehmigte Anfrage abzulehnen, damit Automatisierungen einen Wiederholungsversuch von einer widersprüchlichen Entscheidung unterscheiden können. Erfordert den Scope write:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Eine Anfrage zur Erhöhung des Ausgabenlimits ablehnen in der API-Referenz.

curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"suppress_notification": true}'



Häufig gestellte Fragen



Schließt das direkte Setzen eines Ausgabenlimits die ausstehende Erhöhungsanfrage eines Mitglieds ab?

Nein. POST /v1/organizations/spend_limits schreibt die Überschreibung, lässt die ausstehende Anfrage aber unberührt. Verwende POST /v1/organizations/spend_limit_increase_requests/{id}/approve, um die Anfrage abzuschließen und die Überschreibung in einem Aufruf zu schreiben.



Was passiert, wenn ich eine nutzerspezifische Überschreibung lösche?

Das Mitglied fällt auf das zurück, was es aus der Hierarchie erben würde: seinen Gruppen-, Seat-Tier- oder Organisationsstandardwert. Wenn auf keiner Ebene ein Standardwert existiert, ist das Mitglied unbegrenzt.



Kann ich über diese API einen Seat-Tier- oder organisationsweiten Standardwert setzen?

Nein. Über diese API können nur nutzerspezifische Überschreibungen geschrieben werden. Standardwerte auf Seat-Tier-, Gruppen- und Organisationsebene werden in den Organisationseinstellungen von claude.ai konfiguriert.



Warum zeigt period_to_date_spend manchmal "0" für ein aktives Mitglied an?

Die Ausgabenablesung kann vorübergehend nicht verfügbar sein; in diesem Fall zeigt das Feld "0" an, anstatt einen Fehler zu werfen. Behandle es als informativ.



Siehe auch