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

# Get Included Group

> Read one group's member count and extra usage limit

Read groups and set an extra usage limit for each member of a group. The limit is not a shared pool. Amounts are euros.

The calls use the workspace API key's `BILLING_API` scope. Writes run as the key's service account owner. This API does not add or remove group members.

> [!NOTE]
>
> Call these routes when `GET /billing/v1/mode` returns `ai-models-included`. Dedicated deployments always return `bring-your-own-keys`, including when Langdock manages the model keys. The other mode returns `409` with `code` `BILLING_MODE_MISMATCH`.

## Base URL

```
https://api.langdock.com/billing/v1/ai-models-included/groups/{groupId}
```

## Prerequisites

* **API key** with the `BILLING_API` scope
* The key owner is a service account that has not been deleted and has an active Admin membership

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

`scimManaged` tells you the identity provider owns membership. You can still change the limit. `memberCount` is the number of members.

`extraUsageLimit` is `limited` or `unlimited`. It does not accept `inherit` or `none`. For a member who inherits, the higher of the plan default and this group limit applies. An unlimited group limit does not override an explicit member cap, extra usage turned off, or the workspace extra usage cap. See [Get Included User](https://docs.langdock.com/en/developer/billing-api/get-included-user.md).

> [!NOTE]
>
> Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on [API Key Best Practices](https://docs.langdock.com/en/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.