---
title: "DELETE /public/v3/orders/{external_id}"
method: DELETE
path: "/public/v3/orders/{external_id}"
tags: ["Manage orders"]
---

# DELETE /public/v3/orders/{external_id}

`DELETE /public/v3/orders/{external_id}`

Updates the status of the order to cancelled. One DELETE request cancels one order. The path parameter specifies the order to cancel. The 201 response containing the external ID confirms the action.

An `external_id` identifying a canceled order cannot be reused to create another order.

## Path parameters

- `external_id` string, required — Order's ID assigned by the retailer; unique within all the retailer's orders manifested to Paack. Can include special characters, excluding a comma, though for further use you need to [encode them](./special-characters). `external_id` equals `tracking_id`.

## Response `201`

Confirms the order of the provided `external_id` has been updated.

- object — Defines the response to a PUT `/public/v3/orders/{external_id}` request.
  - `success` object — Contains the order's external ID that can be used for tracking.
    - `external_id` string, required — Order's ID assigned by the retailer; unique within all the retailer's orders manifested to Paack. Can include special characters, excluding a comma, though for further use you need to [encode them](./special-characters). `external_id` equals `tracking_id`.

## Other responses

- `400` — Returned in case of validation errors. The details are displayed in the `error` array. Note that the response can return only one error at once.<br /><br />To ensure a correct validation of a request:<br />- Body of the request must use a structured JSON format.<br />- All mandatory fields must be defined.<br />- Values for fields in the request must match the specific data type and format, including all limitations (e.g., `external_id` must be unique).
- `401` — Communicates a missing or expired access token for authorization. Currently used also in case of no rights to access the API.
- `403` — :construction: Communicates no rights to access the API. Contact our Customer Solutions team for help. While this HTTP error code is currently not supported the API returns 401.
- `404` — In case the external ID specified in the path parameter doesn't correspond to any order.
- `500` — Returned in case of internal errors, which means the problem is on Paack's side.

---

[API](https://skmtc.dev/paack/apis/orders-api.md) · [All operations](https://skmtc.dev/paack/apis/orders-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paack/orders-api/revisions/2582c46598cc/schema)