[ expenses ]

List expenses

Read a cursor-paginated slice of the expense ledger with optional filters.

GET/api/v1/expenses

Response

application/json

Fields

limitinteger

Number of records to return, from 1 to 100.

cursorstring

Opaque next_cursor from the previous page.

fromdate

Include expenses on or after this ISO date.

todate

Include expenses on or before this ISO date.

merchantstring

Case-insensitive merchant filter.

statusstring

Filter by posted, pending_review, or rejected.

Request

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

Response

{
  "data": [
    {
      "id": "exp_01J...",
      "amount_cents": 650,
      "currency": "USD",
      "amount_display": "$6.50",
      "merchant": "Blue Bottle",
      "category": "Coffee & Cafes",
      "occurred_on": "2026-09-20",
      "notes": null,
      "status": "posted",
      "source": {
        "type": "agent",
        "transport": "api",
        "key_id": "key_01J...",
        "connection_id": null
      },
      "has_receipt": false,
      "created_at": "2026-09-20T12:00:00Z",
      "updated_at": "2026-09-20T12:00:00Z"
    }
  ],
  "next_cursor": "eyJpZCI6ImV4cF8uLi4ifQ"
}