---
title: "Get spending history"
method: GET
path: "/v1/budget/history"
tags: ["budget"]
---

# Get spending history

`GET /v1/budget/history`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/budget/history`
- Auth: HTTP bearer

Returns paginated spend history from the ledger for the authenticated account.
Entries are returned newest-first. Use `before` for cursor-based pagination.
Amounts are in atomic USDC units (1,000,000 = 1.00 USDC).

## Query parameters

- `limit` integer
- `before` string, date-time

## Response `200`

Spending history

- object
  - `agent_id` string
  - `currency` string
  - `atomic_unit` string
  - `entries` object[]
    - `id` string
    - `timestamp` string, date-time
    - `amount_usdc` integer
    - `category` string
    - `description` string
    - `reference_id` string, nullable
  - `summary` object
    - `count` integer
    - `total_usdc` integer
    - `by_category` object
  - `pagination` object
    - `limit` integer
    - `has_more` boolean
    - `next_before` string, date-time, nullable
  - `note` string

## Other responses

- `401`: Unauthorized

---

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