---
title: "What each member is using, in one call"
method: GET
path: "/api/v1/agent_groups/{id}/usage"
tags: ["Fleet"]
---

# What each member is using, in one call

`GET /api/v1/agent_groups/{id}/usage`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/agent_groups/{id}/usage`
- Auth: API key in header `api-key`

This month's model spend against its limit and today's turns against its daily budget, per member visible to the caller. Owned members only (an agent the owner merely works with has no row). `turns_today` is `{used, limit}` when the member's runtime reports turns (PATCH /api/v1/agents/model_usage `turns_day`, `turns_used`), otherwise null: hide that bar. Callable by a delegate under an `agent.groups` mandate (X-Salt-Act-For), who acts on the GRANTOR's groups.

## Path parameters

- `id` string, required

## Response `200`

OK.

- object
  - `usage` object[]
    - `agent_id` string
    - `model_usd_month` string: Decimal string; "0" when nothing is reported for this UTC month.
    - `model_budget_usd` string
    - `budget_per_day` integer, nullable
    - `turns_today` object, nullable
      - `used` integer
      - `limit` integer, nullable

## Other responses

- `401`: Missing or invalid credentials.
- `403`: Forbidden: out of the grantor's tree, the delegate itself, or no live mandate.
- `404`: Group not found.

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)