FinWise API

The budget object

Attributes

idstring

Unique identifier for the budget.

createdAtstring

When the object was created, ISO 8601.

updatedAtstring

When the object was last updated, ISO 8601.

userIdstring

Owner of the object. Always the authenticated user.

transactionCategoryIdnullable string

Category this amount applies to.

transactionCategoryGroupIdnullable string

Group this amount applies to.

amountnullable object

Budgeted amount.

amountnumber

Numeric amount in that currency.

currencyCodestring

ISO 4217 code, e.g. USD, EUR, ZAR.

appliesFromBudgetPeriodstring

First period this amount applies to.

appliesToBudgetPeriodnullable string

Last period this amount applies to. Null means it continues until replaced.

transactionTypeenum

debit (spending) or credit (income).

GET/category-budgets

curl https://api.finwiseapp.io/category-budgets \
  -X GET \
  -H "Authorization: Bearer fw_..." \
  -H "Content-Type: application/json"

const response = await fetch('https://api.finwiseapp.io/category-budgets', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fw_...',
    'Content-Type': 'application/json',
  },
})
const data = await response.json()

The budget object

[
  {
    "id": "22bb33cc-44dd-4eef-9f00-556677889900",
    "createdAt": "2026-03-01T00:00:00.000Z",
    "updatedAt": "2026-03-01T00:00:00.000Z",
    "userId": "f472696c-47ac-4873-98cf-2a1069a1cf45",
    "transactionCategoryId": "a00cb43b-ab06-447c-8aeb-527680b20a50",
    "transactionCategoryGroupId": null,
    "amount": {
      "amount": 600,
      "currencyCode": "USD"
    },
    "appliesFromBudgetPeriod": "2026-03-01T00:00:00.000Z",
    "appliesToBudgetPeriod": null,
    "transactionType": "debit"
  }
]