# Mark or unmark a transaction as tax-only

> PATCH /transactions/{transaction_id}/tax-only

Source: https://docs.trykintsugi.com/reference/2026-07-21/mark-or-unmark-a-transaction-as-tax-only

PATCH /transactions/{transaction_id}/tax-only

Mark or unmark a transaction as tax-only

Reclassify a transaction as tax-only, or restore it. Set `taxOnly` to `true` to mark it: a `SALE` becomes `TAX_COLLECTION` and a credit note becomes `TAX_REFUND`. Set it to `false` to unmark: a `TAX_COLLECTION` restores to `SALE`, and a `TAX_REFUND` re-derives `FULL_CREDIT_NOTE` or `PARTIAL_CREDIT_NOTE` from the amounts. Only `type` changes; every amount is preserved. Marking a type that is already tax-only, or unmarking one that is not, is a no-op that returns the transaction unchanged. A type this cannot apply to, or a locked or already-filed transaction, answers `409`. Updating a transaction you do not own answers `404`, identical to one that does not exist.

Category: Transactions

Path parameters:
transaction_id (string, required) - The unique identifier of the transaction to reclassify.

Request body:
taxOnly (boolean, required) - True to mark the transaction tax-only (a `SALE` becomes `TAX_COLLECTION`; a credit note becomes `TAX_REFUND`). False to unmark it, restoring `SALE` or re-deriving `FULL_CREDIT_NOTE` / `PARTIAL_CREDIT_NOTE`. Only `type` is affected; every amount is preserved.

Response fields:
id (string, required) - Kintsugi's unique identifier for the transaction.
organizationId (string, required) - Organization the transaction belongs to. Present on every row because a portfolio-wide list spans organizations.
externalId (string, required) - Your stable identifier for the transaction.
externalFriendlyId (string) - Human-readable identifier from the source, such as an invoice number; an empty string when the source has only an `externalId`.
date (string, required) - When the transaction occurred. This drives filing-period assignment.
type (PublicTransactionTypeEnum, required) - Document shape of the transaction. Credit-note and tax-refund types reverse or adjust prior sales.
  allowed values: SALE, FULL_CREDIT_NOTE, PARTIAL_CREDIT_NOTE, TAX_REFUND, TAX_COLLECTION
status (PublicTransactionStatusEnum, required) - Settlement state. Only `COMMITTED` counts toward filed liability; `PENDING` may still change.
  allowed values: PENDING, COMMITTED, CANCELLED, FULLY_REFUNDED, PARTIALLY_REFUNDED, INVALID
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt