FinWise API

The transaction object

Attributes

idstring

Unique identifier for the transaction.

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.

descriptionstring

Payee / memo shown in the apps.

originalDescriptionnullable string

Description as imported from the institution.

accountIdstring

Account the transaction belongs to.

amountobject

Signed amount. Debits are negative.

amountnumber

Numeric amount in that currency.

currencyCodestring

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

datestring

Transaction date, ISO 8601.

effectiveDatenullable string

Optional date used for budgeting when it differs from date.

transactionCategoryIdnullable string

Assigned category.

merchantIdnullable string

Assigned merchant / payee.

isTransfernullable boolean

True when this is a transfer between accounts.

isPendingnullable boolean

True while the institution still reports the transaction as pending.

needsReviewnullable boolean

True when the transaction is flagged for review.

notesnullable string

User notes.

isManualnullable boolean

True when you created this transaction (not a bank sync).

parentTransactionIdnullable string

Set on split children.

splitsnullable array of objects

Child lines when this transaction has been split.

fileRecordsnullable array of objects

Attachments on the transaction.

linkedPlannedTransactionIdnullable string

Planned transaction this transaction pays.

linkedOccurrenceDatenullable string

Which occurrence of the planned transaction it pays, as yyyy-MM-dd. Null when the transaction isn't linked.

archiveReasonnullable enum

Why it was archived, when set: duplicate, replaced_by_posted, removed_by_provider, stale_pending, or manual.

archivedAtnullable string

Set when the transaction is archived.

transactionTagsnullable array of objects

Tags currently on the transaction.

GET/transactions?filters={"id":"9da3aab1-be6c-4e6a-9b03-fd50e9aca541"}

curl https://api.finwiseapp.io/transactions?filters={"id":"9da3aab1-be6c-4e6a-9b03-fd50e9aca541"} \
  -X GET \
  -H "Authorization: Bearer fw_..." \
  -H "Content-Type: application/json"

const response = await fetch('https://api.finwiseapp.io/transactions?filters={"id":"9da3aab1-be6c-4e6a-9b03-fd50e9aca541"}', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fw_...',
    'Content-Type': 'application/json',
  },
})
const data = await response.json()

The transaction object

[
  {
    "id": "9da3aab1-be6c-4e6a-9b03-fd50e9aca541",
    "createdAt": "2026-03-14T14:18:22.304Z",
    "updatedAt": "2026-03-14T14:18:22.304Z",
    "description": "Walmart",
    "originalDescription": "WALMART STORE 1234",
    "accountId": "94d2f962-d4e3-4c99-ab47-8c941cea012a",
    "amount": {
      "amount": -56.12,
      "currencyCode": "USD"
    },
    "date": "2026-03-14T00:00:00.000Z",
    "effectiveDate": null,
    "transactionCategoryId": "a00cb43b-ab06-447c-8aeb-527680b20a50",
    "merchantId": "d4dd1cbe-d349-4089-ad63-b98921426656",
    "parentTransactionId": null,
    "splits": null,
    "isManual": true,
    "isTransfer": null,
    "notes": null,
    "userId": "f472696c-47ac-4873-98cf-2a1069a1cf45",
    "archivedAt": null,
    "needsReview": null,
    "isPending": false,
    "pendingTransactionId": null,
    "linkedPlannedTransactionId": null,
    "linkedOccurrenceDate": null,
    "archiveReason": null,
    "transactionTags": [],
    "fileRecords": []
  }
]