Skip to main content
Read how many seats the workspace has paid for, how many active members sit on each plan, and how many paid seats are still free. Amounts are not returned here. This route exists only for mode ai-models-included. The call uses the workspace API key’s BILLING_API scope.
Call this route 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. A seats path under bring-your-own-keys returns 404.

​
Base URL

​
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

​
Read seats

GET /billing/v1/ai-models-included/seats returns seat counts for Business (business) and Business Max (business_max).
paid is the number of subscription seats. assigned is the number of active members on that plan. free is paid seats that no active member on that plan is using. A plan change adds a billed seat when the target plan has no free seat left. The seat change is saved before the subscription update is sent to Stripe. Moving a member does not lower paid for the plan they leave. See Set Included User Plan.
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.