The Discard label API removes shipping labels.

Endpoint

DELETE /v3/shipping/labels/carriers/{carrierShortName}/trackings/{trackingNo}

Function

Key features of this API include:

Returns on damaged items: Discards returned or damaged items (instead of restocking or returning them).
Discard labels: Discards labels on products that should be disposed of, rather than returned to inventory or shipped back to the seller.
Efficiency: Automates the returns and discards process to save time and operational costs.
Integration: You can incorporate this API in your existing system to ensure smooth workflows for managing product returns and product dispositions.

Request sample

curl --request DELETE \ --url https://marketplace.walmartapis.com/v3/shipping/labels/carriers/carrierShortName/trackings/trackingNo \ --header 'accept: application/json'

Modify your code

Keep the accept: application/json header.
Ensure your application handles a JSON response confirming success or failure.

Response sample

200

{ "data": "true"
}

Result

This response confirms that the label discard operation was successful.
data: "true" indicates a label has been successfully discarded.
Your system may use this response to update shipment status and remove discarded label references.

Next Steps

The Create label API lets you buy labels from Walmart to ship orders.

The Shipping estimates API provides the cheapest rate to ship an order.

The Labels detail by purchase order ID API retrieves shipping label information for orders, label generation, formatting, and tracking information for shipping as well as order management.

The Supported carriers API gives you a list of approved Walmart carriers to ship orders.

The Download label API brings up the carrier label when searching by carrier and tracking number.

The Supported carrier package types API provides the package types a carrier offers.

The Create label with multi-package API creates shipping labels for orders with multiple packages.

The Create scan form for labels API groups multiple labels so the carrier can scan a single document at pickup.

The Download scan form API downloads the scan form for a document.

Refer to the Walmart Claims Guide on how to get protection for your shipments.