Spend Limits API

Mit der Spend Limits API kannst du ein Ausgabenlimit für jedes Claude Enterprise-Mitglied festlegen, nachsehen, 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.
• 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), 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 Geldwerte sind Strings in kleinsten Einheiten 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 Format der kleinsten Einheit; 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 Ratenlimit 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 keine Query-Parameter 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 ab 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 List effective spend limits 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 seiner 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 Retrieve a spend limit 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 Create a spend limit 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 Organisationsstandard 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 Delete a spend limit 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 List spend limit increase requests 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 ein aktuelles spend_summary, das das aktuelle effektive Ausgabenlimit und die bisherigen Ausgaben im Zeitraum des Antragstellers 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 ihrer ID. Erfordert den Scope read:spend_limits.

Vollständige Parameterdetails und Response-Schemas findest du unter Retrieve a spend limit increase request 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 angeforderten 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 Approve a spend limit increase request 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. 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 Deny a spend limit increase request 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}'



Beispiel-Workflows

Diese Workflows kombinieren die Spend Limits API mit den Kosten-Endpunkten der Analytics APIs. Die Analytics-Kosten-Endpunkte sind für organisationsweite Ausgabenberichte über einen Datumsbereich konzipiert. GET /spend_limits/effective liefert das Limit, das aktuell für jedes Mitglied gilt. Starte einen Durchlauf mit Analytics, um herauszufinden, welche Mitglieder du dir ansehen solltest, und lies dann ihre aktuellen Limits mit /effective aus.

Spend-Limits-Endpunkte erfordern die spend_limits-Scopes und Analytics-Kosten-Endpunkte erfordern read:analytics; siehe Analytics APIs, um zu erfahren, wie du den Zugriff einrichtest. Alle Geldwerte sind bei beiden Dezimal-Strings in kleinsten Einheiten (Cent). Beide APIs paginieren mit einem opaken Cursor. Setze ein explizites limit und blättere durch next_page, bis es null ist, um die gesamte Organisation abzudecken.



Den Review-Flow für Erhöhungsanfragen automatisieren

Führe einen geplanten Job aus, der ausstehende Anfragen abruft, die Genehmigungsrichtlinie deiner Organisation anwendet und jede Anfrage abschließt.

1. Liste ausstehende Anfragen auf:

   cURL

   

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

   Jede Anfrage enthält die actor.user_id des Antragstellers und ein aktuelles spend_summary mit dessen aktuellem effektiven amount und period_to_date_spend – genug, um ohne separate Abfrage zu entscheiden.

2. Wende deine Richtlinie an. Genehmige zum Beispiel automatisch, wenn der aktuelle amount des Mitglieds unter einem Schwellenwert liegt, und leite größere Limits zur manuellen Prüfung weiter.

3. Schließe jede Anfrage ab. Zum Genehmigen gib das neue Limit an:

   cURL

   

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

   Zum Ablehnen sende stattdessen POST an .../{id}/deny. Übergib suppress_notification: true, wenn dein eigenes System den Antragsteller benachrichtigt.



Mitglieder identifizieren, die nahe an ihrem Ausgabenlimit sind

Finde Mitglieder, die sich ihrem Limit nähern, damit du es erhöhen kannst, bevor sie blockiert werden.

1. Rufe die bisherigen Monatsausgaben jedes Mitglieds über die Analytics API ab (eine Zeile pro Mitglied, standardmäßig höchste Ausgaben zuerst):

   cURL

   

   curl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-06-01T00:00:00Z&limit=1000" \
     --header "x-api-key: $ANALYTICS_API_KEY"

   Jede Zeile enthält actor.user_id, actor.email und amount (die Ausgaben des Mitglieds in Cent). Blättere durch next_page, um die gesamte Organisation abzudecken.

2. Rufe für die Top-Spender (oder alle über einem Dollar-Schwellenwert) die effektiven Limits in Batches ab:

   cURL

   

   curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?user_ids[]=user_01Ab...&user_ids[]=user_01Cd...&limit=100" \
     --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

   Jede Zeile liefert das Limit als amount (null = unbegrenzt, "0" = nur enthaltene Nutzung) zusammen mit period_to_date_spend.

3. Berechne für jedes Mitglied mit einem positiven Limit period_to_date_spend / amount und markiere diejenigen, die deinen Schwellenwert erreichen oder überschreiten (zum Beispiel 80 Prozent). Behandle ein "0"-Limit als bereits am Limit. Es gibt keinen serverseitigen Filter für dieses Verhältnis.

4. Handle bei markierten Mitgliedern: Erhöhe das Limit mit POST /v1/organizations/spend_limits, genehmige eine ausstehende Erhöhungsanfrage, falls eine existiert, oder kontaktiere das Mitglied.



Mitglieder mit sich schnell ändernder Nutzung finden

Identifiziere Mitglieder, deren Ausgaben von Woche zu Woche stark gestiegen sind.

1. Rufe die täglichen Kosten pro Mitglied für die letzten zwei Wochen über die Analytics API ab:

   cURL

   

   curl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-06-09T00:00:00Z&ending_at=2026-06-23T00:00:00Z&bucket_width=1d&limit=1000" \
     --header "x-api-key: $ANALYTICS_API_KEY"

   Mit gesetztem bucket_width umfasst jedes Mitglied eine Zeile pro Tag mit Nutzung; blättere durch next_page, um die vollständige Reihe jedes Mitglieds zu erfassen.

2. Gruppiere Zeilen nach actor.user_id. Summiere für jedes Mitglied die letzten sieben Tage und die vorherigen sieben Tage. Markiere Mitglieder, deren aktuelle Woche die vorherige Woche um dein gewähltes Vielfaches übersteigt (zum Beispiel drei). Kosten der letzten Tage sind vorläufig und können nach oben korrigiert werden; für reproduzierbare Vergleiche setze ending_at auf oder vor ein zuvor zurückgegebenes data_refreshed_at (siehe Datenverfügbarkeit und -aktualität).

3. Handle bei markierten Mitgliedern: Passe das Limit mit POST /v1/organizations/spend_limits an oder kontaktiere das Mitglied.



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 Organisationsstandard. Wenn auf keiner Ebene ein Standard existiert, ist das Mitglied unbegrenzt.



Kann ich über diese API einen Seat-Tier- oder organisationsweiten Standard 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