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 200 sample

{ "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.

• Create label Guide
• Create label API Reference Guide

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

• Shipping estimates Guide
• Shipping estimates API Reference Guide

The Default max ship-on-date API provides recommendations for the default and maximum ship-on-date for orders.

• Default max ship-on-date Guide
• Default max ship-on-date API Reference Guide

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.

• Labels detail by purchase order ID Guide
• Labels detail by purchase order ID API Reference Guide

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

• Supported carriers Guide
• Supported carriers API Reference Guide

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

• Download label Guide
• Download label API Reference Guide

The Discard label API removes shipping labels.

• Discard label Guide 
• Discard label API Reference Guide

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

• Supported carrier package types Guide
• Supported carrier package types API Reference Guide

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