[ summary & budgets ]

Get spending summary

Return confirmed spend and category totals for one calendar month.

GET/api/v1/summary

Response

application/json

Fields

monthstring

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

Request

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

Response

{
  "data": {
    "month": "2026-09",
    "total_cents": 384219,
    "expense_count": 48,
    "budget_remaining_cents": 115781,
    "by_category": [
      {
        "category": "Groceries",
        "amount_cents": 68420
      }
    ]
  }
}