Amazon SP-API Deprecation Deadlines: Key Migrations Sellers Must Complete by Mid-2025
Amazon will retire several SP‑API components, with the first cutoff on 26 Feb 2025 for the LISTING_ITEM_ISSUES_CHANGE v1.0 notification payload, followed by Catalog Items API v0 ending 31 Mar 2025 and twelve XML/flat‑file feed types retiring on 30 Jun 2025. Sellers must switch to the JSON‑based LISTING_ITEM_ISSUES_CHANGE schema, the v2022‑04‑01 Catalog API, and JSON_LISTINGS_FEED feeds to avoid errors.
Overview
Amazon has announced final removal dates for several outdated Selling Partner API (SP‑API) components, with the earliest cutoff on 26 February 2025. The deprecations affect notification payloads, catalog‑lookup endpoints, and a suite of XML‑based feed types, meaning any integration that still calls these legacy services will start returning errors once the deadlines pass. Sellers must verify that their custom code or third‑party tools have migrated to the newer JSON‑based alternatives to avoid disruptions in listing management, inventory updates, and pricing adjustments.
Key Points
- Listing‑issue notification v1.0 — The first deadline arrives on 26 Feb 2025; any system still parsing the old LISTING_ITEM_ISSUES_CHANGE payload will miss critical alerts about listing problems.
- Catalog Items API v0 — Both
listCatalogItemsandgetCatalogItemcalls will stop working after 31 Mar 2025, forcing a switch to the v2022‑04‑01 version for product data retrieval. - Twelve legacy feed types — XML and flat‑file feeds such as POST_PRODUCT_DATA and POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA are retired on 30 Jun 2025, with JSON‑based feed options recommended as replacements.
- Reduced throttling already in effect — Since 31 Dec 2024, Amazon has lowered request limits on the deprecated Catalog Items API, causing slower response times for any integration that has not yet upgraded.
- Vendor accountability — Third‑party software providers are expected to complete their migration plans before the respective cutoffs; sellers should obtain concrete timelines to confirm compliance.
What's Changing
- Notification payload upgrade — Systems that listen for LISTING_ITEM_ISSUES_CHANGE must adopt the new JSON schema; for example, a seller’s alert service that previously extracted the “issueCode” field from XML will need to map the same data from the revised “issueDetails” object.
- Catalog API version shift — Calls to
listCatalogItemsmust be redirected to the v2022‑04‑01 endpoint, which supports pagination tokens and richer attribute filters; a typical inventory‑sync script that queried 10,000 SKUs in batches of 500 will now receive up to 1,000 items per request, reducing overall API calls.
Analysis & Recommendations
Why This Matters
If migration is not completed, calls will return 404 or 429 errors, halting listing issue alerts, inventory syncs, and price updates. Reduced throttling already limits the legacy Catalog API to ~100 requests/min, causing frequent rate‑limit failures for high‑volume scripts. Compliance ensures continuous data flow and prevents costly downtime.
Key Takeaways
- Listing‑issue notification v1.0 stops on 26 Feb 2025; payload changes to a JSON ‘issueDetails’ object.
- Catalog Items API v0 (listCatalogItems, getCatalogItem) is deprecated after 31 Mar 2025; use the v2022‑04‑01 endpoint with up to 1,000 items per re...
- Twelve XML/flat‑file feeds, including POST_PRODUCT_DATA and POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA, retire on 30 Jun 2025; replace them wi...
- Since 31 Dec 2024 the legacy Catalog API throttling was lowered to ~100 requests/min, requiring exponential back‑off logic.
Recommended Actions
- →Update notification handlers: In your webhook code, replace XML parsing of LISTING_ITEM_ISSUES_CHANGE with JSON parsing of the ‘issueDetails’ field...
- →Migrate catalog calls: In Seller Central > Settings > Developer Settings, register the v2022‑04‑01 Catalog API endpoint and modify all scripts to c...
- →Switch feed generation: In your bulk‑upload tool, change the output format from XML/flat‑file to JSON_LISTINGS_FEED and test submissions via the SP...
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!