> ## 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: Nutzer abrufen

> Lies Plan, gespeichertes Extra-Nutzungslimit und das effektive Limit eines Mitglieds

Liste aktive menschliche Mitglieder, ändere einen Plan und setze das Extra-Nutzungslimit. Beträge sind Euro.

Die Aufrufe laufen über den `BILLING_API` Scope des Workspace-API-Schlüssels. Schreibzugriffe laufen als der Service Account, dem der Schlüssel gehört. Diese API lädt niemanden ein und deaktiviert niemanden. Dafür nutzt du die [User Management API](https://docs.langdock.com/de/developer/user-management-api/user-management-overview.md).

> [!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/users/{userId}
```

## 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`, `name` oder einen E-Mail-Filter brauchst

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

```json theme={null}
{
  "id": "11111111-1111-4111-8111-111111111111",
  "email": "jane@example.com",
  "name": "Jane Doe",
  "plan": "business_max",
  "extraUsageLimit": {
    "configured": { "type": "inherit" },
    "effective": {
      "type": "limited",
      "amount": 150,
      "source": { "type": "plan" }
    }
  },
  "extraUsagePeriodSpend": 12.4
}
```

`plan` ist `business` (**Business**) oder `business_max` (**Business Max**).

`configured` ist das am Mitglied gespeicherte Limit: `inherit`, `limited` oder `unlimited`. `inherit` heißt, das Mitglied hat keine eigene Obergrenze. Ein explizites `limited` oder `unlimited` schlägt den Plan und jede Gruppe.

`effective` ist das Limit, das gilt. Bei `inherit` gilt der höhere Wert aus Plan-Standard und Gruppenlimits. Ein unbegrenzter Wert schlägt einen begrenzten. Bei gleichem Betrag schlägt die Gruppe den Plan. Setzen zwei Gruppen denselben Betrag, ist die Quelle die Gruppe, deren Name zuerst kommt. `source.type` ist `plan`, `group`, `user` oder `workspace`. Eine `group`-Quelle enthält zusätzlich `groupId` und `groupName`.

`source` ist `user`, wenn das Mitglied eine eigene Obergrenze hat. Eine unbegrenzte Gruppe hebt diese Obergrenze nicht auf. `source` ist `workspace` und der effektive Betrag ist null, wenn die Extra-Nutzung für den Workspace aus ist. Ein unbegrenztes Limit eines Mitglieds oder einer Gruppe hebt diesen Schalter und das Extra-Nutzungslimit des Workspace nicht auf.

`extraUsagePeriodSpend` ist die Extra-Nutzung im aktuellen Zeitraum. Der Wert ist `null`, wenn der Workspace die Ausgaben pro Nutzer ausblendet. Ein Nutzer, der kein aktives menschliches Mitglied ist, gibt `404` zurück.

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