FinWise API
SupportChangelog

The account object

Attributes

idstring
Unique identifier for the account.
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.
namestring
Institution or given name.
displayNamenullable string
Optional name shown in the apps.
friendlyNamenullable string
Alternate name from the institution, when provided.
emojinullable string
Emoji used in the apps.
accountNumbernullable string
Masked account number or IBAN.
currentBalancenullable object
Latest balance.
amountnumber
Numeric amount in that currency.
currencyCodestring
ISO 4217 code, e.g. USD, EUR, ZAR.
availableBalancenullable object
Available-to-spend balance, when the institution provides one.
amountnumber
Numeric amount in that currency.
currencyCodestring
ISO 4217 code, e.g. USD, EUR, ZAR.
limitAmountnullable object
Credit limit, when the institution provides one.
amountnumber
Numeric amount in that currency.
currencyCodestring
ISO 4217 code, e.g. USD, EUR, ZAR.
currencyOverridenullable string
Force this account to display in a specific currency.
typenullable enum
One of cash, bank, creditCard, savings, investment, crypto, vehicle, property, retirementFund, rewards, loan, other.
subTypenullable string
Finer institution type, when known.
accountGroupIdnullable string
Group this account belongs to.
isLinkednullable boolean
True when the account is connected through a bank provider.
institutionIdnullable string
Financial institution, when linked.
institutionUserIdnullable string
Bank connection this account came from, when linked.
archivedAtnullable string
Set when the account is archived.
datanullable object
Display and inclusion flags.
confignullable object
Per-account preferences.
excludeFromBudgetnullable boolean
Hide this account’s transactions from budgets.
excludeFromNetWorthnullable boolean
Hide this account from net worth.
excludeTransactionsnullable boolean
Ignore this account’s transactions entirely.
invertAmountsnullable boolean
Flip the sign of balances and amounts.
GET/accounts/94d2f962-d4e3-4c99-ab47-8c941cea012a
curl https://api.finwiseapp.io/accounts/94d2f962-d4e3-4c99-ab47-8c941cea012a \
  -X GET \
  -H "Authorization: Bearer fw_..." \
  -H "Content-Type: application/json"
const response = await fetch('https://api.finwiseapp.io/accounts/94d2f962-d4e3-4c99-ab47-8c941cea012a', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fw_...',
    'Content-Type': 'application/json',
  },
})
const data = await response.json()
The account object
{
  "id": "94d2f962-d4e3-4c99-ab47-8c941cea012a",
  "createdAt": "2026-03-14T09:15:46.724Z",
  "updatedAt": "2026-03-14T09:15:46.724Z",
  "userId": "f472696c-47ac-4873-98cf-2a1069a1cf45",
  "name": "Chase Sapphire",
  "displayName": "Travel card",
  "friendlyName": null,
  "accountNumber": "••••4291",
  "currentBalance": {
    "amount": -3432,
    "currencyCode": "USD"
  },
  "availableBalance": {
    "amount": 1568,
    "currencyCode": "USD"
  },
  "limitAmount": null,
  "currencyOverride": null,
  "type": "creditCard",
  "subType": "credit card",
  "archivedAt": null,
  "isLinked": true,
  "institutionId": "b8cb6f04-2f2b-440a-a55f-6708ebb57130",
  "institutionUserId": null,
  "accountGroupId": "c1a0c0a0-1b2c-4d5e-8f90-1234567890ab",
  "emoji": "💳",
  "logoBase64": null,
  "data": {
    "config": {
      "excludeFromBudget": false,
      "excludeFromNetWorth": false,
      "excludeTransactions": false,
      "invertAmounts": false
    }
  }
}