List Included Groups - Docs

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.

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

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

limit defaults to 50 and cannot exceed 250. Pass cursor from nextCursor. The list response is { "groups": [ ... ] } and includes nextCursor until the last page. Each group is the object described on Get Included Group.

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.