Cancel a parcel

POST {{baseUrl}}/parcels/:id/cancel

You can use this endpoint to:

  1. Cancel an announced parcel; or,
  2. Delete an unnanounced parcel

Cancelling a parcel

When you cancel a parcel which is already announced (has a shipping label attached to it), you will still be able to find it via the parcel_id and the Retrieve a parcel endpoint. In the Sendcloud panel, it will appear in your Cancelled labels overview.

Insurance Notice: If you proceed to ship a parcel that was initially cancelled, the parcel's insurance coverage will become void, and any insurance claims will not be valid for that shipment.

After 42 days, it's no longer possible to cancel a parcel, even if it hasn't been shipped.

Deleting a parcel

When you delete a parcel which hasn't been announced, the parcel will be removed from the Sendcloud system and you will no longer be able to locate it via the parcel id. You will need to create the parcel again if you want to announce it at a later date.

Conditions for label cancellation

It's not always possible to cancel a parcel which is aleady announced. As a result, cancellation is not guaranteed and may be asynchronous depending on the state of the parcel. When you send a cancellation request via this endpoint, the response will indicate the status of the cancellation request.

Each carrier will have different cancellation deadlines. Some carriers do not accept cancellation requests regardless of whether or not the label is cancelled within the deadline. You can find more information about cancellation deadlines on our Help Center.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"status":"\u003cstring\u003e","message":"\u003cstring\u003e"}