GET

/v1/transactions

List transactions

Returns transactions for accounts the API key can read, newest first. Results are paginated with a cursor.

Bearer token. Requires the transactions:read scope.

Query parameters

NameTypeRequiredDescription
account_idstringOptionalOnly return transactions for this account, e.g. acc_6021.
fromdateOptionalEarliest posted date, inclusive. Format YYYY-MM-DD.
todateOptionalLatest posted date, inclusive. Format YYYY-MM-DD.
categorystringOptionalFilter by category slug, e.g. groceries or dining.
statusenumOptionalpending or posted. Defaults to both.
limitintegerOptionalItems per page, 1 to 200. Defaults to 50.
cursorstringOptionalThe next_cursor value from a previous response.
curl "https://api.wiseowl.app/v1/transactions?from=2026-09-01&limit=2" \
  -H "Authorization: Bearer wo_test_4f9c...92e7" \
  -H "WiseOwl-Version: 2026-09-01"

Response

200 OK
{
  "object": "list",
  "has_more": true,
  "next_cursor": "cur_9fT2xQ",
  "data": [
    {
      "id": "txn_8Hq2kV41mZ",
      "amount": -8647,
      "currency": "usd",
      "merchant": {
        "name": "Trader Joe's"
      },
      "category": "groceries",
      "status": "posted",
      "posted_at": "2026-09-29T17:42:10Z"
    }
  ]
}