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

# Seats abrufen

> Lies bezahlte, vergebene und freie Seats für Business und Business Max

Lies, wie viele Seats der Workspace bezahlt hat, wie viele aktive Mitglieder auf jedem Plan sitzen und wie viele bezahlte Seats noch frei sind. Beträge stehen hier nicht. Diese Route gibt es nur für den Modus `ai-models-included`.

Der Aufruf nutzt den `BILLING_API` Scope des Workspace-API-Schlüssels.

> [!NOTE]
>
> Diese Route gilt, 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`. Ein Seats-Pfad unter `bring-your-own-keys` gibt `404` zurück.

## Basis-URL

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

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

## Seats lesen

`GET /billing/v1/ai-models-included/seats` liefert die Seat-Zahlen für **Business** (`business`) und **Business Max** (`business_max`).

```json theme={null}
{
  "business": { "paid": 40, "assigned": 38, "free": 2 },
  "business_max": { "paid": 8, "assigned": 7, "free": 1 }
}
```

`paid` ist die Zahl der Abo-Seats. `assigned` ist die Zahl der aktiven Mitglieder auf diesem Plan. `free` sind bezahlte Seats, die kein aktives Mitglied auf diesem Plan nutzt.

Ein Planwechsel fügt einen berechneten Seat hinzu, wenn der Zielplan keinen freien Seat mehr hat. Die Seat-Änderung wird gespeichert, bevor das Abo-Update an Stripe geht. Ein Wechsel senkt `paid` für den Plan, den das Mitglied verlässt, nicht. Den Plan setzt du unter [Extra-Nutzung: Plan setzen](https://docs.langdock.com/de/developer/billing-api/set-included-user-plan.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.