API Ahead

Editions

API Ahead · Amazon SP-API — 27 May – 26 August 2026

What changed in the Amazon Selling Partner API between 27 May 2026 and 26 August 2026, and what it means for your code.

3 breaking · 3 silent risk · 94 additive · 14 API models touched

Category Count
🔴 Breaking 3
🟠 Silent risk 3
🟢 Additive 94

🔴 Breaking (3)

These will fail loudly. Fix before Amazon enforces them.

Amazon Warehousing And Distribution / awd_2024-05-09

  • Enum value(s) removed from GET /awd/2024-05-09/inboundShipments/{shipmentId}/labels :: pageType: LETTER_6, THERMAL_NONPCP
  • If you send any of these values the request will be rejected. If you store them, historical records may no longer validate.

Orders / orders_2026-01-01

  • Field ItemProceedsBreakdown.subtotal is now required
  • Requests that omit it will be rejected.
  • Field ItemProceedsBreakdown.type is now required
  • Requests that omit it will be rejected.

🟠 Silent risk (3)

These will NOT fail at deploy time. They fail in production, later, on a subset of records. This is the section that costs people weekends.

Listings Items / listingsItems_2021-08-01

  • Allowed values now documented for Issue.categories[]: DUPLICATE, INVALID_ATTRIBUTE, INVALID_IMAGE, INVALID_PRICE, LISTING, MISSING_ATTRIBUTE, MISSING_IMAGE, MISSING_PRICE, PRODUCT, QUALIFICATION_REQUIRED
  • The field's type did not change, so a standard OpenAPI diff sees nothing here. But Amazon has now pinned down what this field can contain. If your code maps this field to a fixed set of values, check that every one of these is handled.

Orders / orders_2026-01-01

  • New enum value(s) in GET /orders/2026-01-01/orders :: includedData: FULFILLMENT_ORDERS
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.
  • New enum value(s) in GET /orders/2026-01-01/orders/{orderId} :: includedData: FULFILLMENT_ORDERS
  • This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.

🟢 Additive (94)

New surface area. Nothing breaks — read only if you're curious.

Amazon Warehousing And Distribution / awd_2024-05-09

  • New schema: FormatType
  • New endpoint: GET /awd/2024-05-09/inboundShipments/{shipmentId}/labelPageTypes
  • New endpoint: GET /awd/2024-05-09/outboundOrders
  • New endpoint: GET /awd/2024-05-09/outboundOrders/{orderId}
  • New schema: InventoryDetailsVisibility
  • New schema: OrderAttribute
  • New schema: OrderPreference
  • New schema: OrderPreferenceValue
  • New schema: OutboundExecutionError
  • New schema: OutboundListing
  • New schema: OutboundOrder
  • New schema: OutboundOrderCreationData
  • New schema: OutboundOrderReference
  • New schema: OutboundShipment
  • New schema: OutboundStatus
  • New endpoint: POST /awd/2024-05-09/outboundOrders
  • New endpoint: POST /awd/2024-05-09/outboundOrders/{orderId}/confirmation
  • New endpoint: PUT /awd/2024-05-09/outboundOrders/{orderId}
  • New schema: PageType
  • New schema: ShipmentLabelPageTypes
  • New schema: ShipmentSortableField
  • New schema: SkuQuantitiesVisibility
  • New schema: SortOrder

Finances / financesInvoices_2026-06-25

  • New API model published: Finances / financesInvoices_2026-06-25

Finances / finances_2024-06-19

  • New schema: Balance

…and 69 more additive changes across 14 models.

Source: the OpenAPI models Amazon publishes, compared version to version. No scraping, no guessing: if it's listed here, it's in the spec.

API Ahead is free. It tells you what changed in the API.

If you'd rather be told what changed in your repo — the file, the line, and a pull request with the fix — that's what we're building next. Reply and we'll put you on the pilot list.

The OpenAPI models are © Amazon.com, Inc. or its affiliates, released under the Apache License 2.0. This newsletter is an independent analysis of those public models: it is not affiliated with, sponsored by, or endorsed by Amazon. Amazon and Selling Partner API are trademarks of Amazon.com, Inc. or its affiliates.