Skip to main content
POST
/
shipments
/
{id}
/
cancel
Cancel a shipment
curl --request POST \
  --url https://panel.sendcloud.sc/api/v3/shipments/{id}/cancel \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": {
    "status": "cancelled",
    "message": "Shipment has been cancelled"
  }
}
You can use this endpoint to Cancel an announced shipment.

​
Cancelling a shipment

When you cancel a shipment which is already announced (has shipping labels attached to it), you will still be able to find it via the id and the Retrieve a shipment endpoint. In the Sendcloud platform, it will appear in your Cancelled labels overview. Insurance Notice: If you proceed to send a shipment 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 shipment, even if it hasn’t been sent.

​
Conditions for label cancellation

It’s not always possible to cancel a shipment whose parcel has already been announced. As a result, cancellation is not guaranteed and may be asynchronous depending on the state of the shipment 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.

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 shipment

Response

Cancelled

  • The shipment has been cancelled if all valid conditions apply.
​
data
Cancel Shipment Status Object · object
required