/v1/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
| Name | Type | Required | Description |
|---|---|---|---|
| account_id | string | Optional | Only return transactions for this account, e.g. acc_6021. |
| from | date | Optional | Earliest posted date, inclusive. Format YYYY-MM-DD. |
| to | date | Optional | Latest posted date, inclusive. Format YYYY-MM-DD. |
| category | string | Optional | Filter by category slug, e.g. groceries or dining. |
| status | enum | Optional | pending or posted. Defaults to both. |
| limit | integer | Optional | Items per page, 1 to 200. Defaults to 50. |
| cursor | string | Optional | The 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"
}
]
}