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

> Read one agent's monthly budget, budget mode, and spend in euros

Read and update monthly agent budgets in euros. Use the `ai-models-included` prefix for this workspace mode.

The calls use the workspace API key's `BILLING_API` scope. Writes run as the key's service account owner.

> [!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/agents/{agentId}
```

## 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": "33333333-3333-4333-8333-333333333333",
  "name": "Contract reviewer",
  "budget": { "type": "limited", "amount": 40 },
  "budgetMode": "always",
  "budgetPeriodSpend": 18.7
}
```

`name` may be `null`. `budgetPeriodSpend` is `null` when the workspace hides per user spend, and on a write.

When per user spend is hidden, agents that are not shared are left out of the list. Reading or updating one of those agents returns `404` and changes nothing. Shared agents stay in the list with `budgetPeriodSpend` set to `null`.

A configured budget is enforced only while extra usage is on. While extra usage is off, the stored budget is not applied and spend stays at zero.

> [!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.