[ summary & budgets ]

Get budgets

Compare each monthly category budget with confirmed spend and remaining cents.

GET/api/v1/budgets

Response

application/json

Fields

monthstring

Month in YYYY-MM format. Defaults to the current month.

Request

curl 'https://www.agentcents.com/api/v1/budgets' \
  -H 'Authorization: Bearer ac_live_YOUR_KEY_HERE'

Response

{
  "data": {
    "month": "2026-09",
    "budgets": [
      {
        "category": "Dining & Restaurants",
        "limit_cents": 50000,
        "spent_cents": 3240,
        "remaining_cents": 46760
      }
    ]
  }
}