---
title: "Delete parcels by ID."
method: POST
path: "/v1/parcels/delete"
tags: ["parcels"]
---

# Delete parcels by ID.

`POST /v1/parcels/delete`

## Request

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

Permanently deletes the specified parcels. Only parcels that have not yet been shipped can be deleted. This is an **all-or-nothing** operation — if any parcel cannot be deleted, none of the parcels in the request will be deleted.

## Request body

- DeleteParcels
  - `parcel_ids` string[], required: List of parcels to be deleted

## Response `202`

All specified parcels were successfully deleted.

## Other responses

- `401`: Unauthorized. Missing or invalid authentication token.
- `404`: One or more parcels were not found.
- `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)