Back to FinWise
API reference

Changelog

Additive changes can ship any time. Breaking changes are listed here.

29 October 2026

  • New API keys are read-only unless you choose Full access when you create them. A read-only key gets 403 on any request that creates, changes or deletes, apart from revoking itself. Existing keys keep their access.

14 October 2026

  • Breaking: an API key or MCP connection on an account with no active subscription or trial is refused with 403 and error.code subscription_required. It works again once the user resubscribes. Errors may now carry an optional code.

27 August 2026

  • Authorization accepts both Bearer fw_… and a raw fw_… key.
  • Documented PATCH /transactions/:id, tags, merchants, category groups, budgets, planned transactions, account groups, holdings, and /account-balances/aggregated3.
  • List pagination metadata is in x-count, x-page-number, x-page-size, and x-has-next-page headers.

30 April 2024

  • Initial public API.