Amazon Shutting Down Catalog Items v0 API — Developers Must Migrate by March 2026
Amazon will retire the SP‑API Catalog Items v0 on 31 Mar 2026, removing the `listCatalogCategories` endpoint. Integrations must switch to the Catalog Items v2022‑04‑01 API and add the `includeData=classifications` flag to retrieve category data.
Overview
Amazon will retire the legacy Selling Partner API (SP‑API) Catalog Items v0 on 31 March 2026. The shutdown eliminates the final functional endpoint—listCatalogCategories—and forces every integration that still relies on v0 to move to the newer Catalog Items v2022‑04‑01 API. Sellers and developers must act now to keep category data flowing into their listing, advertising, and pricing workflows.
Key Points
- Endpoint removal — The
listCatalogCategoriescall, which delivered ASIN‑level browse hierarchy, will stop responding after 31 Mar 2026. Any request to/catalog/v0/…will return an error. - Full v0 retirement — With the category endpoint gone, the entire v0 version will have zero usable operations, making the migration mandatory, not optional.
- New API version — The replacement is the Catalog Items v2022‑04‑01 API, which offers a
classificationsinclude‑data option that replicates the old category tree in a richer JSON structure. - Different response schema — Field names, nesting, and data types have changed, so existing parsers must be rewritten to handle the new format.
- Rate limits — The updated endpoints allow up to five requests per second with a burst capacity of five, matching the legacy limits but requiring the same throttling logic.
- Role requirement — Calls to the new API need the Product Listing role; most accounts already have it, but verification is essential before switching.
How Migration Works
- Redirect endpoint URLs — Change every call from
/catalog/v0/categoriesto/catalog/2022-04-01/items.- Example: A script that previously fetched
https://sellingpartnerapi-na.amazon.com/catalog/v0/categories?asin=B00XYZmust now requesthttps://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items?asin=B00XYZ&includeData=classifications.
- Example: A script that previously fetched
Analysis & Recommendations
Why This Matters
After 31 Mar 2026 any request to `/catalog/v0/...` will error, halting category‑based listings, advertising targeting, and fee calculations. Migrating to v2022‑04‑01 with the new `classifications` schema ensures continued data flow and compliance with Amazon's fee schedule.
Key Takeaways
- The `listCatalogCategories` call stops responding after 31 Mar 2026, rendering the entire v0 catalog API unusable.
- Migration target is Catalog Items v2022‑04‑01 API; include `includeData=classifications` to get the browse hierarchy.
- Rate limits remain 5 requests/second with a burst of 5, so existing throttling logic can be reused.
- New calls require the Product Listing IAM role (`sellingpartnerapi::catalog::items` permission).
Recommended Actions
- →In your codebase, replace all `/catalog/v0/categories` URLs with `/catalog/2022-04-01/items`.
- →Add `includeData=classifications` to each request and update parsers to read `response.classifications[0].id` and `name`.
- →In the AWS IAM console, attach the “Amazon SP‑API – Product Listing” managed policy to the role used by your integration and test the new calls in ...
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!