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

# Get spending caps

`GET /v1/budget`

## Request

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

Returns current spending caps and remaining budget for the authenticated account.
Amounts are in atomic USDC units (6 decimals). 1,000,000 = 1.00 USDC.

## Response `200`

Current budget caps and status

- object
  - `agent_id` string
  - `currency` string
  - `atomic_unit` string
  - `caps` object: Per-period spending caps. Each period is null (no cap) or a cap object.
    - `daily` object, nullable
      - `limit_usdc` integer
      - `spent_usdc` integer
      - `remaining_usdc` integer
      - `resets_at` string, date-time
    - `weekly` object, nullable
      - `limit_usdc` integer
      - `spent_usdc` integer
      - `remaining_usdc` integer
      - `resets_at` string, date-time
    - `monthly` object, nullable
      - `limit_usdc` integer
      - `spent_usdc` integer
      - `remaining_usdc` integer
      - `resets_at` string, date-time
  - `has_caps` boolean
  - `status` 'active' | 'limit_reached'
  - `settings` object
    - `on_limit` 'reject' | 'approve'
    - `single_tx_limit_cents` integer, 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)