> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extra-Nutzung: Nutzungslimit-Anfragen auflisten

> Liste Anfragen von Mitgliedern nach mehr Nutzung in einem Workspace mit inkludierten AI-Modellen

Liste Anfragen von Mitgliedern nach mehr Nutzung, lies eine Anfrage und lehne eine Anfrage ab, die noch offen ist. Es gibt keinen Webhook. Frage die Liste ab.

Um eine Anfrage zu genehmigen, hebe den Plan des Mitglieds auf **Business Max** oder erhöhe das Extra-Nutzungslimit und übergib `usageRequestId` an diesem Schreibzugriff. Siehe [Extra-Nutzung: Plan setzen](https://docs.langdock.com/de/developer/billing-api/set-included-user-plan.md) und [Extra-Nutzungslimit setzen](https://docs.langdock.com/de/developer/billing-api/set-user-extra-usage-limit.md).

Die Aufrufe laufen über den `BILLING_API` Scope des Workspace-API-Schlüssels. Die Ablehnung läuft als der Service Account, dem der Schlüssel gehört.

> [!NOTE]
>
> Diese Routen gelten, wenn `GET /billing/v1/mode` den Modus `ai-models-included` liefert. Ein Dedicated Deployment liefert immer `bring-your-own-keys`, auch wenn Langdock die Modellschlüssel verwaltet. Der andere Modus antwortet mit `409` und `code` `BILLING_MODE_MISMATCH`.

## Basis-URL

```
https://api.langdock.com/billing/v1/ai-models-included/usage-requests
```

## Voraussetzungen

* **API-Schlüssel** mit dem Scope `BILLING_API`
* Der Besitzer ist ein Service Account, der nicht gelöscht ist und eine aktive Admin-Mitgliedschaft hat
* `USER_MANAGEMENT_API` am selben Schlüssel, wenn du `email` oder `name` brauchst

Mitglieder können nur anfragen, wenn `usageRequestsEnabled` an ist. `status` ist `pending`, `resolved` oder `dismissed`. Lass ihn weg, um jeden Status zu listen. Die Ergebnisse kommen älteste zuerst. `limit` ist standardmäßig 50 und höchstens 250. Gib `cursor` aus `nextCursor` zurück. Ein Cursor aus einem anderen Workspace gibt `400` mit `code` `INVALID_CURSOR`. Eine Anfrage, die zwischen zwei Seiten beantwortet wird, überspringt spätere Zeilen nicht.

Die Listenantwort ist `{ "usageRequests": [ ... ] }` und enthält `nextCursor` bis zur letzten Seite. Eine einzelne Anfrage zu lesen liefert das Anfrageobjekt. Eine Anfrage außerhalb dieses Workspace gibt `404` mit `code` `NOT_FOUND`.

Ausgeblendete Ausgaben pro Nutzer blenden diese Anfragen nicht aus. Ein Mitglied, das ein Limit erreicht und nicht anfragt, steht nicht in dieser Liste.

Zum Abfragen rufst du `GET /usage-requests?status=pending` auf und überspringst die Anfragen, die du schon bearbeitet hast.

> [!NOTE]
>
> Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu [Best Practices für API-Schlüssel](https://docs.langdock.com/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.