@get-asset/react

Similar Transactions

Styled expandable table for similar unconfirmed transactions, with the largest groups first. Each lead row shows its group size beside the merchant name and expands from anywhere on the row. The lead row's ✓ confirms the whole group, while a member's ✓ confirms only that transaction. The ✕ opens an inline reason form; affected rows read as reviewing while the correction routing runs. Confirming the final group replaces the table with the Done “All caught up” state.

Built on the headless SimilarTransactions compound from @get-asset/sdk.

Preview

Loading preview…

Required scopes

The access token used by AssetProvider must include these scopes for this primitive to fetch data successfully:

transaction:update
transaction:read
external_account:read
journal_entry:read
journal_entry:create
chat:create

API reference

Root props

Prop	Type	Default	Description
`title`	`ReactNode`	`"Similar transactions"`	Card heading.
`limit`	`number`	`10`	Maximum number of count-ranked groups to show. The component considers up to 50 groups from the API.
`accountIds`	`string[]`	—	Only include transactions for these external account ids.
`hiddenColumns`	`SimilarTransactionsColumn[]`	—	Columns to omit from the table. Options: "expand", "date", "transaction", "account", "amount", and "category". "expand" controls the chevron gutter. All columns are shown by default.
`groups`	`SimilarTransactionGroupOverride[]`	—	Override the groups shown and skip fetching. Used by storybook/tests.
`state`	`"loading" \| "error" \| "empty"`	—	Force a specific state for testing.
`onConfirmed`	`(transactionIds: string[]) => void`	—	Called after transactions are confirmed, with the confirmed ids.
`onContextSubmitted`	`(transactionId: string, message: string) => void`	—	Called after a correction's review flow has run, with the transaction id and submitted message.
`className`	`string`	—	Forwarded to the outer Card element.

States

LoadingSkeleton rows aligned column-for-column with the visible table header.

Loading preview…

SuccessThe expandable transaction table, ranked by group size.

Loading preview…

EmptyYou’re all caught up — nothing needs categorizing.

Loading preview…

ErrorErrorState with the fetched message and a retry action.

Loading preview…

DoneThe finished "All caught up" state after every group is confirmed.

Loading preview…