---
title: "Cancel the delivery of the specified parcels."
method: POST
path: "/v1/parcels/deliver/cancel"
tags: ["delivery"]
---

# Cancel the delivery of the specified parcels.

`POST /v1/parcels/deliver/cancel`

## Request

- Base URL: `https://logistics.api.cabify-sandbox.com`
- URL: `https://logistics.api.cabify-sandbox.com/v1/parcels/deliver/cancel`
- Auth: HTTP bearer

Cancels an in-progress delivery for the given parcels, when cancellation is still permitted. Delivery cannot be cancelled once the parcel has been picked up. Cancellation is allowed in the following states: `qualifiedforpickup`, `onroutetopickup`, and `pickingup`. Please note that cancellation may incur costs.

## Request body

- CancelParcels
  - `parcel_ids` string[], required: List of parcels to be cancelled

## Response `202`

Cancellation request accepted and is being processed.

## Other responses

- `401`: Unauthorized. Missing or invalid authentication token.
- `404`: One or more parcels were not found.
- `409`: One or more parcels cannot be cancelled due to their current state. Cancellation is only allowed in the `qualifiedforpickup`, `onroutetopickup`, or `pickingup` states.
- `422`: The request is not valid for the current delivery. This happens when only some of the parcels grouped in the same delivery are sent: all the parcels of the delivery must be cancelled together in a single request.
- `429`: Too many requests. This API is rate limited per account and per endpoint. A 429 is an expected condition rather than a failed request: back off and retry it. The limits are not the same for every endpoint and can change, so handle the status instead of hard-coding a rate. See the Limits and reliability guide.

---

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