---
title: "v2-cancelOrderLines - Cancel order lines"
method: POST
path: "/v2/orders/{order_id}/cancel"
tags: ["Orders"]
---

# v2-cancelOrderLines - Cancel order lines

`POST /v2/orders/{order_id}/cancel`

<div class="extension-title">Description</div>

Use this API to cancel order lines (all or part) of an order.

<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: At each cancel request</div>
<div class="max-call-frequency">Maximum usage: At each cancel request</div>
</div>

## Path parameters

- `order_id` string, required

## Request body

- CancelOrderLinesRequest
  - `cancelations` CancelRequest[], required — Cancelations details related to an order
    - `order_line_id` string — Unique order line identifier used by Mirakl Connect. ID of the order line to cancel.
    - `price` Money, required
      - `amount` number, required — Price amount
      - `currency` string, iso-4217, required — Currency ISO code
    - `product_id` string — Seller product identifier on the channel
    - `quantity` integer, required — Product quantity to cancel
    - `reason` string, required — The reason why the order line is canceled Enum: `"CUSTOMER_CANCELATION"`, `"OUT_OF_STOCK"`, `"RETURN"`, `"ITEM_NOT_RECEIVED"`, `"AGREEMENT"`, `"DEFECT"`, `"UNABLE_TO_DELIVER"`
    - `shipping_price` Money, required
      - `amount` number, required — Price amount
      - `currency` string, iso-4217, required — Currency ISO code
    - `shipping_taxes` CanceledTaxRequest[] — Shipping taxes to cancel
      - `amount` Money, required
        - `amount` number, required — Price amount
        - `currency` string, iso-4217, required — Currency ISO code
      - `code` string, required — Tax code on the sales channel
    - `taxes` CanceledTaxRequest[] — Taxes to cancel
      - `amount` Money, required
        - `amount` number, required — Price amount
        - `currency` string, iso-4217, required — Currency ISO code
      - `code` string, required — Tax code on the sales channel

## Response `202`

Accepted. The cancel request will be processed asynchronously.

- AsynchronousActionResponse
  - `action_id` string, required — The unique identifier for the asynchronous action. It should be used with the [v2-getActionStatus API](#operation/v2-getActionStatus) to retrieve current action status and potential errors.
  - `tracking_id` string — **Deprecated:** This field was previously used to obtain the action ID. It has been replaced by `action_id` and contains the same value. It is retained for backward compatibility.

## Other responses

- `400` — The order has not been updated because of wrong or missing parameters.
- `404` — The order has not been updated because the order does not exist.

---

[API](https://skmtc.net/mirakl/apis/mirakl-connect-apis.md) · [All operations](https://skmtc.net/mirakl/apis/mirakl-connect-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mirakl/mirakl-connect-apis/revisions/cc009fec5cdd/schema)