May 2026 SP-API Release
Amazon's May 2026 SP‑API release adds new endpoints for inventory‑health (e.g., sell‑throughRate) and advertising metrics, tightens schemas with mandatory fields like buyerTaxInfo, and raises rate limits with visible x‑amz‑ratelimit‑remaining headers. Deprecated endpoints will return 410 after their announced retirement dates.
Overview
Amazon released the May 2026 version of its Selling Partner API (SP‑API) this week. The update adds fresh endpoints, tightens data schemas, raises request limits, and publishes a definitive retirement timetable for legacy calls. Sellers and developers who rely on Amazon’s marketplace APIs need to adjust their integrations now to avoid disruptions and to take advantage of the new data points.
Key Points
- New endpoints introduced — The May rollout brings additional resources that expose inventory‑health indicators and advertising‑performance metrics, expanding the data surface for automation.
- Schema updates — Revised JSON definitions now mandate extra attributes for order fulfillment and pricing, driving consistency across API interactions.
- Deprecation schedule announced — Amazon provides exact dates when older endpoints will cease, giving sellers a clear migration window.
- Standardized error payloads — All failure responses now follow a uniform structure with coded identifiers and human‑readable messages, reducing debugging effort.
- Higher rate limits — Select high‑volume operations receive larger request quotas, allowing bigger batch pulls without hitting throttling thresholds.
- Unified documentation portal — Release notes, deprecation timelines, and schema changes are consolidated into a searchable hub, simplifying reference for development teams.
How the May 2026 Changes Work
- Endpoint activation — When a request targets one of the newly published resources, Amazon validates it against the latest schema and returns data in the new format. Example: A call to
/listings/v2026-05-01/itemsnow includes a “sell‑throughRate” field alongside quantity and price. - Schema enforcement — Calls that omit any of the newly required fields are rejected with a 400 Bad Request that contains a specific error code. Example: Submitting a
createOrderpayload without the mandatory object triggers an error response indicating the missing element.
Analysis & Recommendations
Why This Matters
Missing the new mandatory fields will trigger 400 Bad Request errors, disrupting order processing. Deprecated calls will start returning 410 Gone, breaking integrations unless migrated before the May 2026 retirement dates. Higher quotas and standardized errors enable larger batch jobs and faster debugging, crucial for peak sales periods.
Key Takeaways
- New endpoints like /listings/v2026-05-01/items now include a "sell‑throughRate" field.
- Schema updates require the buyerTaxInfo object in createOrder payloads, otherwise a 400 error occurs.
- Rate‑limit headers (x‑amz‑ratelimit‑remaining) now show remaining quota, e.g., 950/1000 after a bulk update.
Recommended Actions
- →Update all API calls in your codebase to use the 2026‑05‑01 versioned endpoints (e.g., replace /orders/v2025-12-01/getOrder with /orders/v2026-05-0...
- →Add the required buyerTaxInfo object to every createOrder request and test for 400 responses using the new error payload format.
- →Implement monitoring of the x‑amz‑ratelimit‑remaining header in your integration and pause batch jobs when the remaining count drops below 100, as ...
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!