GET /2026-05/cloud/label/{id}/cancellation-status

Method: GET

URL:

Sandbox URL:

Description: Retrieves the ZhenHub cancellation status. New cancellation requests complete locally in the Cancel Shipping Label API response; this endpoint remains available for compatibility with earlier asynchronous requests.

Parameters

Parameter	Description	Type
id	Label ID returned by the Create Shipping Label API.	Long, Required

Response

{
  "code": 200,
  "message": "OK – The request was successful.",
  "data": {
    "id": 8050996080689152,
    "status": "cancelled"
  }
}

Status	Description	Client action
cancelling	A cancellation submitted before immediate local cancellation was enabled is still being processed.	Poll again.
cancelled	Cancellation completed successfully. This is terminal.	Mark the label cancelled.
cancellation_failed	A legacy asynchronous cancellation stopped retrying and did not complete.	Submit the cancellation request again if the label has not been scanned.

Notes

• New cancellation requests return cancelled directly and do not require polling.
• A 409 response means cancellation was not requested for this label.
• A 404 response means the label does not exist or does not belong to the authenticated account.