Walmart Marketplace API deprecation guide
This guide explains how Walmart Marketplace APIs move through legacy, deprecated, and sunset states, what each status means, and how to transition to supported APIs.
Terminology
Walmart Marketplace APIs may be classified using the following terms:
- Active: The API is fully supported and recommended for use. Active APIs receive ongoing enhancements, updates, and support.
- Legacy: The API remains supported and fully functional but is no longer recommended for new integrations. Legacy APIs do not receive new features or enhancements. Walmart recommends migrating to the preferred alternative.
- Deprecated: The API is scheduled for removal in a future release and should no longer be used. Deprecated APIs remain available for a limited time but receive no new features and only critical security or stability fixes. A deprecated API includes a published deprecation date and sunset date. All integrations should migrate before sunset.
- Sunset: After the sunset date, the API is permanently retired. The API may be disabled or removed, requests may return error responses, and no support, fixes, or patches are provided. Documentation may be archived or removed. Continued use after the sunset date is not supported.
Deprecation lifecycle
Marketplace APIs typically follow this progression. Not all APIs move through every stage, but deprecated APIs always have a defined sunset date.
API lifecycle status and timeline
| API / Endpoint | Lifecycle / Status | Migration Path | Status date | Sunset date |
|---|---|---|---|---|
| WFS inventory | Legacy | WFS inventory (New) | September 03, 2025 | March 03, 2026 |
| Create carrier rate quote | Legacy | Create carrier rate quote (New) | February 06, 2026 | February 06, 2027 |
| Get carrier rate quote | Legacy | Get carrier rate quote (New) | February 06, 2026 | February 06, 2027 |
| Confirm carrier rate quote | Legacy | Create booking (New) | February 06, 2026 | February 06, 2027 |
| Print carrier label | Legacy | Generate label (New) and Download label (New) | February 06, 2026 | February 06, 2027 |
| Cancel carrier rate quote | Legacy | Cancel booking (New) | February 06, 2026 | February 06, 2027 |
| Price management | Deprecated | Pricing and promotions API (New) | October 24, 2025 | 2026 |
Insights proseller badge (GET /v3/insights/prosellerbadge) | Sunset | Functionality discontinued | December 13, 2024 | August 13, 2025 |
Trending items (GET /v3/insights/items/trending) | Sunset | Functionality discontinued | October 12, 2024 | March 31, 2025 |
Support policy
- Legacy APIs: May receive critical security and stability fixes
- Deprecated APIs: Only critical security or stability fixes until sunset
- Sunset APIs: No support is provided
Frequently asked questions
- Can legacy APIs be used for new integrations?
Legacy APIs continue to work, but new integrations should use the recommended alternatives. - Will deprecated APIs receive bug fixes?
After deprecation, only critical security or stability issues may be addressed until sunset. - How do I know when an API becomes deprecated?
Deprecation status is published in documentation and communicated through API response headers. - What happens if we don’t stop using deprecated APIs by the end date?
After the sunset date, the API may be disabled or removed. Requests can fail and return error responses, which may cause service disruption. Walmart does not provide support for sunset APIs. - How can I tell if I am utilizing one of these APIs?
You can identify deprecated APIs by:- Checking API documentation for deprecation notices
- Reviewing API response headers that indicate deprecation status
- Monitoring communications and announcements related to Marketplace APIs
- Are you planning to deprecate more APIs in the future?
Walmart Marketplace continuously evolves its APIs. As newer, improved APIs become available; older APIs may be marked as legacy or deprecated. Deprecation notices are communicated in advance to allow sufficient time for migration.
Updated 1 day ago