Skip to main content
POST
/
parcels
/
{id}
/
cancel
Cancel a parcel
curl --request POST \
  --url https://panel.sendcloud.sc/api/v2/parcels/{id}/cancel \
  --header 'Authorization: Basic <encoded-value>'
{
  "status": "cancelled",
  "message": "Parcel has been cancelled"
}
API v2 is entering maintenance mode. New users should start with API v3 to access our latest features and improved performance. Already using v2? Don’t worry, your current integration remains fully functional. Read more about maintenance mode, or check out the migration guide for API v3.
You can use this endpoint to:
  1. Cancel an announced parcel; or,
  2. Delete an unannounced parcel

​
Cancelling a parcel

When you cancel a parcel which has already been 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 platform, 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.

​
Conditions for label cancellation

It’s not always possible to cancel a parcel which has already been 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 has 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 in our help center.

​
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.

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Path Parameters

​
id
string
required

ID of the parcel

Response

Cancelled

  • The parcel has been cancelled if all valid conditions apply.
​
status
string
required
Minimum string length: 1
​
message
string
required
Minimum string length: 1