The Discard label API removes shipping labels.

Endpoint

DELETE https://marketplace.walmartapis.com/v3/shipping/labels/carriers/{carrierShortName}/trackings/{trackingNo}

Function

Key features of this API include:

Return damaged items: Discard returned or damaged items (instead of restocking or returning them).
Discard labels: Discard labels on products that should be disposed of rather than returning it to inventory or shipping it back to the seller.
Efficiency: Automate the return and discard process to save time and operational costs.
Integration: Incorporate the Discard label API into your existing system to ensure smooth workflows on product returns.
Correcting labels: Discard an incorrect label and create a new one.

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 the JSON response confirming success or failure.

Response sample

{ "data": "true"
}

Result

The response confirms that the label discard operation was successful.

data: "true" indicates the label has been successfully discarded.

Your system can use this confirmation to update shipment status and remove references to the discarded label.

Next Steps

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

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

The Label details by purchase order ID API procures shipping label information on multiple orders such as label generation, carrier service type, shipment tracking, shipment protection, and signature protection.

The Supported carriers API provides a list of Walmart's approved carriers to ship orders.

The Download label API retrieves a carrier label by the carrier and tracking number.

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

The Create scan form for labels API creates a scan form (also called a shipping manifest) to group multiple labels together for a carrier to scan a single document at pickup.

The Download scan form API downloads a scan form document from the manifestId.

The Get ship-on-date API provides recommendations for the default ship-on-date and maximum ship-on-date on seller orders.