---
title: "Set transaction tax only"
method: POST
path: "/v1/transactions/{transaction_id}/tax_only"
tags: ["Transactions"]
---

# Set transaction tax only

`POST /v1/transactions/{transaction_id}/tax_only`

## Request

- Base URL: `https://api.trykintsugi.com`
- URL: `https://api.trykintsugi.com/v1/transactions/{transaction_id}/tax_only`
- Auth: API key in header `X-API-KEY`

Mark or unmark a transaction as tax-only. SALE becomes TAX_COLLECTION; credit notes become TAX_REFUND. Unmark restores SALE or re-derives FULL/PARTIAL credit note. Only the type is changed; amounts are preserved.

## Path parameters

- `transaction_id` string, required

## Headers

- `x-organization-id` string, nullable, required: The unique identifier for the organization making the request

## Request body

- TaxOnlyUpdate
  - `tax_only` boolean, required: True to mark as tax-only; false to remove the tax-only marking.

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/trykintsugi/apis/tax-platform.md) - [All operations](https://skmtc.dev/trykintsugi/apis/tax-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/trykintsugi/apis/tax-platform/revisions/00512519f0d4?raw)