API Ahead

Editions

API Ahead · Amazon SP-API — 31 July – 26 August 2026

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

1 silent risk · 9 additive · 4 API models touched

Category Count
🟠 Silent risk 1
🟢 Additive 9

🟠 Silent risk (1)

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.

🟢 Additive (9)

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

Notifications / notifications

  • Schema EventFilter now also composes: ref:TrackingFilter
  • New endpoint: GET /notifications/v1/subscriptions
  • New schema: GetSubscriptionsPayload
  • New schema: GetSubscriptionsResponse
  • New schema: Subscriptions
  • New schema: TrackingFilter
  • New schema: TrackingIdentifier

Promotions / promotions_2025-12-01

  • New API model published: Promotions / promotions_2025-12-01

Tracking / tracking_2026-01-30

  • New API model published: Tracking / tracking_2026-01-30

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.