---
title: "Get Agent Balances"
method: GET
path: "/api/billing/agents/balance"
tags: ["billing"]
---

# Get Agent Balances

`GET /api/billing/agents/balance`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/billing/agents/balance`
- Auth: none declared

The balance that actually pays for each owned agent + burn/runway.

TOS-7302: ``balance_usd`` is the balance of whoever is charged for the
agent's turns (its primary owner under the default ``owner_pays``), not the
agent's own wallet, so the card's funding state matches the charge.
``caller_pays`` agents are omitted: their callers pay. ``paid_by_you`` says
whether that payer is the viewer; when it is not, the row carries only the
funding state, never another person's amounts (see
:func:`agent_balance_payload`).

## Query parameters

- `window_days` integer

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)