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 listCatalogCategories call, 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 classifications include‑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

1. Redirect endpoint URLs — Change every call from /catalog/v0/categories to /catalog/2022-04-01/items.
   • Example: A script that previously fetched https://sellingpartnerapi-na.amazon.com/catalog/v0/categories?asin=B00XYZ must now request https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items?asin=B00XYZ&includeData=classifications.