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

> Liste aktive Mitglieder mit Plan und Extra-Nutzungslimit

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

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

`plan` ist `business` oder `business_max`. `email` ist eine exakte Adresse und ignoriert Groß- und Kleinschreibung. `limit` ist standardmäßig 50 und höchstens 250. Gib `cursor` aus `nextCursor` zurück.

Um ein Mitglied über die E-Mail zu finden, ruf `GET /users?email=jane%40example.com` mit einem Schlüssel auf, der auch den User-Management-Scope hat, und ändere danach über die zurückgegebene `id`.

Die Listenantwort ist `{ "users": [ ... ] }` und enthält `nextCursor` bis zur letzten Seite. Jedes Mitglied hat die Form von [Extra-Nutzung: Nutzer abrufen](https://docs.langdock.com/de/developer/billing-api/get-included-user.md).

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