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

> Lies Mitgliederzahl und Extra-Nutzungslimit einer Gruppe

Lies Gruppen und setze ein Extra-Nutzungslimit für jedes Mitglied einer Gruppe. Das Limit ist kein gemeinsamer Topf. 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 fügt keine Gruppenmitglieder hinzu und entfernt keine.

> [!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/groups/{groupId}
```

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

```json theme={null}
{
  "id": "22222222-2222-4222-8222-222222222222",
  "name": "Sales",
  "scimManaged": true,
  "memberCount": 31,
  "extraUsageLimit": { "type": "limited", "amount": 200 }
}
```

`scimManaged` sagt dir, dass der Identity Provider die Mitgliedschaft besitzt. Das Limit kannst du trotzdem ändern. `memberCount` ist die Zahl der Mitglieder.

`extraUsageLimit` ist `limited` oder `unlimited`. Es akzeptiert weder `inherit` noch `none`. Für ein Mitglied mit `inherit` gilt der höhere Wert aus Plan-Standard und diesem Gruppenlimit. Ein unbegrenztes Gruppenlimit hebt eine eigene Obergrenze des Mitglieds, ausgeschaltete Extra-Nutzung und das Extra-Nutzungslimit des Workspace nicht auf. Siehe [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.