Overview

On January 30 2025 Amazon launched a comprehensive redesign of its Selling Partner API (SP‑API) reference documentation. The update adds full response payload examples and interactive request snippets for 20 programming languages, aiming to cut development time for sellers and third‑party developers. All legacy reference pages will be retired on June 28 2025, giving integration teams a five‑month window to transition.

Key Points

• Full Response Payloads — Every endpoint now displays a complete JSON example, including every field, nested object, and data type, so developers can see exactly what Amazon returns without trial calls.
• Interactive Request Samples — Code snippets are live and adapt to user input, illustrating how to build valid requests for each operation.
• Twenty Language Coverage — Sample code is provided for Python, Java, Go, Rust, Ruby, PHP, TypeScript and 13 additional languages, expanding beyond the previous handful of examples.
• Redesigned Layout — The reference site follows modern documentation standards, with clearer navigation, searchable sections, and consistent formatting across all APIs.
• Hard Cutover Date — All older documentation will disappear on June 28 2025, forcing developers to adopt the new reference by that deadline.

How the New Documentation Works

1. Select an Endpoint — Users choose an API operation (e.g., GET /orders/v0/orders) from the left‑hand navigation tree. The page instantly shows a collapsible “Response Example” panel containing a fully populated JSON object, such as an order with fields like orderId, purchaseDate, orderStatus, and nested shippingAddress.
2. View Language‑Specific Code — Below the response panel, a tab strip lists the 20 supported languages. Clicking the “Go” tab reveals a ready‑to‑run snippet that constructs the request, sets required headers, and parses the example response into Go structs. The same request can be viewed in Rust, Ruby, or PHP with a single click, eliminating manual translation.