---
title: "Get agent spend"
method: GET
path: "/v1/agents/{id}/spend"
tags: ["Agents"]
---

# Get agent spend

`GET /v1/agents/{id}/spend`

Amount submitted in each limit window and what remains. Windows are UTC calendar day and month; DRAFT, FAILED, CANCELLED, and REVERSED transfers are excluded.

## Path parameters

- `id` string, required

## Headers

- `X-API-Key` string

## Response `200`

- AgentSpendResponseDto
  - `agentId` string, required
  - `currency` string, required
  - `perTransaction` string, required — Configured per-transaction cap, smallest unit
  - `day` AgentSpendWindowDto, required
    - `limit` string, nullable, required — Configured cap in smallest unit; null = uncapped
    - `used` string, required — Submitted in this window, smallest unit
    - `remaining` string, nullable, required — limit - used; null when uncapped
    - `resetsAt` string, date-time, required — Start of the next window (UTC)
  - `month` AgentSpendWindowDto, required
    - `limit` string, nullable, required — Configured cap in smallest unit; null = uncapped
    - `used` string, required — Submitted in this window, smallest unit
    - `remaining` string, nullable, required — limit - used; null when uncapped
    - `resetsAt` string, date-time, required — Start of the next window (UTC)

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials

## Changes

- **2026-09-23** `da62fa03793e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/infinite/apis/infinite-api/changes/v1/agents/:id/spend/get.md)

---

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