> ## 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-Anfrage abrufen

> Lies die Anfrage eines Mitglieds 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/{requestId}
```

## 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

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

```json theme={null}
{
  "id": "44444444-4444-4444-8444-444444444444",
  "userId": "11111111-1111-4111-8111-111111111111",
  "email": "ada@example.com",
  "name": "Ada Lovelace",
  "status": "resolved",
  "createdAt": "2026-10-01T08:30:00.000Z",
  "resolvedAt": "2026-10-01T09:05:00.000Z",
  "resolution": "increased_limit",
  "resolvedByUserId": "55555555-5555-4555-8555-555555555555"
}
```

`email` und `name` sind nur enthalten, wenn der Schlüssel auch `USER_MANAGEMENT_API` hat. Ohne diesen Scope fehlen die Felder. `name` kann `null` sein, wenn es enthalten ist.

`resolution` ist `increased_limit`, `upgraded_plan`, `dismissed` oder `null`, solange die Anfrage offen ist. `resolvedAt` und `resolvedByUserId` sind `null`, solange sie offen ist. `resolvedByUserId` ist der Admin oder Service Account, der die Anfrage beantwortet hat.

> [!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.