FinWise API
SupportChangelog

List planned transactions

Query parameters

filtersnullable object
JSON object, passed as a query-string value.
paginationnullable object
JSON object with pageNumber and pageSize.
pageNumbernullable number
1-based page. Defaults to 1.
pageSizenullable number
Items per page. Defaults to 100.
GET/planned-transactions
curl https://api.finwiseapp.io/planned-transactions \
  -X GET \
  -H "Authorization: Bearer fw_..." \
  -H "Content-Type: application/json"
const response = await fetch('https://api.finwiseapp.io/planned-transactions', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fw_...',
    'Content-Type': 'application/json',
  },
})
const data = await response.json()
Response
[
  {
    "id": "aa1bb2cc-dd3e-4f50-a162-27488990abcd",
    "createdAt": "2026-03-14T09:00:00.000Z",
    "updatedAt": "2026-03-14T09:00:00.000Z",
    "userId": "f472696c-47ac-4873-98cf-2a1069a1cf45",
    "description": "Rent",
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": null,
    "amount": {
      "amount": -2200,
      "currencyCode": "USD"
    },
    "frequency": "monthly",
    "transactionCategoryId": "a00cb43b-ab06-447c-8aeb-527680b20a50",
    "merchantId": null,
    "accountId": "94d2f962-d4e3-4c99-ab47-8c941cea012a",
    "status": "active",
    "flexibleAmountMin": null,
    "flexibleAmountMax": null,
    "variableFixedPercent": null
  }
]