---
title: "POST /api/transactions/{id}/cancellations"
method: POST
path: "/api/transactions/{id}/cancellations"
tags: ["api", "transactions"]
---

# POST /api/transactions/{id}/cancellations

`POST /api/transactions/{id}/cancellations`

Create a Transaction cancellation

## Path parameters

- `id` string, required — The ID of the transaction

## Request body

- object
  - `items` union, required
    - string[]
    - object[]
      - `_id` string, required
      - `amount` number, required
  - `refundFunds` boolean, required — Whether the received funds should be refunded
  - `refundTarget` 'origin' | 'voucher' | 'customer_balance', required — The method to use for refunding the transaction.

## Response `200`

OK

- POSTTransactionsCreateATransactionCancellation200Response
  - `transactionId` string, required
  - `sellerId` string, required
  - `cancelledItems` object[]
    - `cartItemId` string, required — The ID of the cart to which the item belongs to
    - `type` 'ticket' | 'product' | 'fee' | 'discount' | 'fulfillment' | 'insurance', required — The type of the item indicated where it originated from
    - `name` string, nullable — The name of the item
    - `price` number, float, required — The price of the item
    - `taxRate` number, float — The applied tax rate for that item
    - `origin` union — Object indicating where the item originated from
      - object
        - `fee` object — The cancellation fee of the item
          - `_id` string, required — The ID of the fee component.
          - `amount` number, float — The fee amount.
          - `value` number, float — The fee value.
          - `total` number, float — The fee total. Calculated with amount and value.
          - `type` 'onTicket' | 'onFreeTicket' | 'onPosTicket' | 'onKioskTicket' | 'onFreePosTicket' | 'onFreeKioskTicket' | 'onSeasonTicket' | 'onHardTicket' | 'onTicketCustom' | 'onCart' | 'onPosCart' | 'onKioskCart' | 'onFreeCart' — The fee type of the fee component.
          - `name` string, nullable — The name of the fee.
          - `publicName` string — The public name of the fee component.
          - `exposed` boolean — Whether this fee will be exposed to the ticket buyer.
          - `scheme` object — The fee scheme of the fee component.
            - `schemeId` string — The ID of the fee scheme.
            - `feeId` string — The ID of the fee scheme fee.
      - object
        - `ticketTypeId` string — The ID of the ticket type this ticket inherits from
      - object
        - `productVariantId` string — The ID of the product variant this product inherits from
    - `cancellationFee` object — The cancellation fee of the item. Is set when cancellation fees are charged at cancellation
      - `_id` string, required — The ID of the fee component.
      - `amount` number, float — The fee amount.
      - `value` number, float — The fee value.
      - `total` number, float — The fee total. Calculated with amount and value.
      - `type` 'onTicket' | 'onFreeTicket' | 'onPosTicket' | 'onKioskTicket' | 'onFreePosTicket' | 'onFreeKioskTicket' | 'onSeasonTicket' | 'onHardTicket' | 'onTicketCustom' | 'onCart' | 'onPosCart' | 'onKioskCart' | 'onFreeCart' — The fee type of the fee component.
      - `name` string, nullable — The name of the fee.
      - `publicName` string — The public name of the fee component.
      - `exposed` boolean — Whether this fee will be exposed to the ticket buyer.
      - `scheme` object — The fee scheme of the fee component.
        - `schemeId` string — The ID of the fee scheme.
        - `feeId` string — The ID of the fee scheme fee.
    - `refundId` string — The ID of the refund. Is set when item was refunded
    - `cancelledAt` string, date-time — A date indicating when the item has been cancelled
  - `refundId` string
  - `refundTarget` string
  - `refundSource` string
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2026-09-21** `54ee7c45865f` — 20 warning
  - added the new `onFreeCart` enum value to the `cancelledItems/items/cancellationFee/type` response property for the response status `200`
  - added the new `onFreeCart` enum value to the `cancelledItems/items/origin/oneOf[subschema #1]/fee/type` response property for the response status `200`
  - added the new `onFreeKioskTicket` enum value to the `cancelledItems/items/cancellationFee/type` response property for the response status `200`
  - added the new `onFreeKioskTicket` enum value to the `cancelledItems/items/origin/oneOf[subschema #1]/fee/type` response property for the response status `200`
  - …16 more

[Change history](https://skmtc.dev/vivenu/apis/vivenu-api/changes/api/transactions/:id/cancellations/post.md)

---

[API](https://skmtc.dev/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.dev/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vivenu/apis/vivenu-api/revisions/ff78046ac535?raw)