---
title: "Cancellation"
method: POST
path: "/api/cancel"
tags: ["Automation Endpoints"]
---

# Cancellation

`POST /api/cancel`

Mark a previously submitted order as cancelled. If the order has not yet been reviewed, it is excluded from future review. If the order has already been reviewed and approved, canceling it will also trigger a full refund on any associated charges.

 This endpoint is used when an order is fully cancelled after submission.

## Headers

- `x-riskified-shop-domain` string, required
- `x-riskified-hmac-sha256` string, required
- `content_type` 'application/json', required
- `accept` 'application/vnd.riskified.com; version=2', required

## Request body

- CancelOrderWrapper
  - `order` Cancel, required
    - `id` string, required — The unique identifier of the order to cancel.
    - `cancel_reason` string, required — A reason for cancelling or fully refunding the order.
    - `cancelled_at` string, date-time, required — When the order was cancelled, ISO8601 format.

## Response `200`

Successful operation

- CancelResponse — Cancel Response
  - `order` object
    - `id` string, required — Unique ID of order being acted upon. Note: This value should be later reflected also as order.id on the subsequent calls
    - `status` 'cancelled', required — Textual status describing the result of Riskified analysis. Always 'approve' for approved orders. Order is approved and guaranteed by Riskified
    - `description` string, required — Additional context on Riskified decision.
    - `old_status` string, required — Old order status

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `429` — Too many requests
- `500` — Contact Riskified support
- `504` — Temporary error, please retry

---

[API](https://skmtc.dev/riskified/apis/chargeback-guarantee.md) · [All operations](https://skmtc.dev/riskified/apis/chargeback-guarantee/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/riskified/chargeback-guarantee/revisions/2b7df5bce861/schema)