> For the complete documentation index, see [llms.txt](https://docs.shipbubble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shipbubble.com/api-reference/shipments/cancel-shipment.md).

# Cancel shipment

You can utilize this endpoint to cancel **only a scheduled shipment** i.e a shipment that has been processed for a future date. It will be canceled once the date for processing has not passed.

<mark style="color:green;">`POST`</mark> `https://api.shipbubble.com/v1/shipping/labels/cancel/:order_id`

#### Path Parameters

| Name                                        | Type   | Description       |
| ------------------------------------------- | ------ | ----------------- |
| order\_id<mark style="color:red;">\*</mark> | String | shipment order id |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "status": "success",
    "message": "Shipment successfully cancelled"
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```javascript
{
    "status": "failed",
    "message": "Shipment label already processed"
}
```

{% endtab %}
{% endtabs %}
