Zippyy REST APIs
  1. Shipments
Zippyy REST APIs
  • Introduction
  • Authentication API
    • Generate Token
      POST
  • Couriers
    • Check Courier Serviceability
      GET
    • Quick Quote
      POST
    • Forward Shipment (V2)
      POST
    • Forward Shipment
      POST
  • Shipments
    • Get Details of Specific Shipment
      GET
    • Generate Label
      GET
    • Generate Label Url
      GET
    • Cancel a Shipment
      PUT
    • Generate Invoice
      GET
  • Tracking
    • Get Tracking Details
      GET
    • Webhook
      POST
  • NDR
    • Action NDR
      PUT
  • Warehouse
    • Get Warehouse
      GET
    • List of Warehouse details
      GET
    • Create new Warehouse
      POST
    • Update existing warehouse properties
      PUT
  1. Shipments

Cancel a Shipment

PUT
/v1/external/shipments/{orderId}/cancel

Cancel Shipment#

This endpoint allows you to cancel a shipment associated with a specific order.

Request#

Method: PUT
Endpoint: {{base_url}}/v1/external/shipments/{orderId}/cancel

Path Parameters#

orderId (string): The unique identifier of the order whose shipment is to be canceled.

Response#

Upon a successful request, the API will return a response with the following structure:
Status: 200 OK
Content-Type: application/json
id (string): The unique identifier for the canceled shipment.
createdAt (string): The timestamp when the cancellation was created.
updatedAt (string): The timestamp when the cancellation was last updated.
refundStatus (string): The status of the refund process.
trackingCode (string): The tracking code associated with the shipment.
This endpoint is essential for managing shipments and ensuring that users can effectively handle order cancellations.

Request

Header Params

Responses

🟢200200 OK - Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/v1/external/shipments//cancel' \
--header 'Authorization: {{auth_token}}'
Response Response Example
{
    "id": "shp_fe75ed838d8840a5b4d545ace8fba050",
    "createdAt": "1750079495822",
    "updatedAt": "1750079495822",
    "refundStatus": "pending",
    "trackingCode": "6901910800973"
}
Modified at 2025-08-04 19:55:15
Previous
Generate Label Url
Next
Generate Invoice
Built with