---
title: "Delete multiple parcels in bulk"
method: DELETE
path: "/api/v{version}/parcels/bulk"
tags: ["orders"]
---

# Delete multiple parcels in bulk

`DELETE /api/v{version}/parcels/bulk`

Deletes up to 200 parcels in a single request. 
            Returns detailed success/failure information for each parcel.
            
            Important notes:
            - ExchangeReturn parcels cannot be deleted
            - If a parcel has a ReturnParcel, it will also be deleted
            - If deleting a ReturnParcel, the OriginalParcel's IsExchanged flag will be reset

            Response Status Codes:
            - 200 OK: All parcels deleted successfully
            - 207 Multi-Status: Partial success (some parcels deleted, some failed)
            - 400 Bad Request: All parcels failed validation or deletion

## Path parameters

- `version` string, required

## Headers

- `X-Tenant` string, required

## Request body

- DeleteBulkParcelsRequest
  - `parcelIds` string[], nullable

## Response `200`

OK

- DeleteBulkParcelsResponse
  - `totalRequested` integer
  - `successCount` integer
  - `failureCount` integer
  - `successes` BulkParcelDeleteSuccess[], nullable
    - `index` integer
    - `parcelId` string, uuid
    - `trackingNumber` string, nullable
  - `failures` BulkParcelDeleteFailure[], nullable
    - `index` integer
    - `parcelId` string, uuid
    - `errorCode` string, nullable
    - `errorMessage` string, nullable

## Other responses

- `207` — Multi-Status
- `400` — Bad Request

---

[API](https://skmtc.net/zrexpress/apis/zrexpress-api.md) · [All operations](https://skmtc.net/zrexpress/apis/zrexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zrexpress/zrexpress-api/versions/99b075e0b641/schema)