API Ahead

Editions

API Ahead · Amazon SP-API — 28 September – 5 October 2026

What changed in the Amazon Selling Partner API between 28 September 2026 and 5 October 2026, and what it means for your code.

37 breaking · 6 silent risk · 172 additive · 1 announcement · 14 API models touched

Category Count
🔴 Breaking 37
🟠 Silent risk 6
🟢 Additive 172
📣 Amazon announcements 1

🔴 Breaking (37)

These will fail loudly. Fix before Amazon enforces them.

Notifications / FulfillmentOrderStatusNotification

  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.EventType
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentOrderStatus
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentReturnItem
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentReturnItem.ReceivedDateTime
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentReturnItem.ReturnedQuantity
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentReturnItem.SellerSKU
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.AmazonShipmentId
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.EstimatedArrivalDateTime
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.FulfillmentShipmentPackages
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.FulfillmentShipmentPackages.FulfillmentShipmentPackageItem
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.FulfillmentShipmentPackages.FulfillmentShipmentPackageItem.CarrierCode
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.FulfillmentShipmentPackages.FulfillmentShipmentPackageItem.PackageNumber
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.FulfillmentShipmentPackages.FulfillmentShipmentPackageItem.TrackingNumber
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.FulfillmentShipment.FulfillmentShipmentStatus
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.SellerFulfillmentOrderId
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.SellerId
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • Field removed: FulfillmentOrderStatusNotification.Payload.FulfillmentOrderStatusNotification.StatusUpdatedDateTime
  • Any code reading this field will get null/KeyError. Check parsing and downstream mapping.
  • New required field: FulfillmentOrderStatusNotification.Payload.eventType
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.merchantId
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.lineItems[].amount
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.lineItems[].lineItemId
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.lineItems[].product
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.lineItems[].product.productIdentifier
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.orderId
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].amazonFacility.facilityId
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].amazonShipmentId
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].items
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].items[].amount
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].items[].lineItemId
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].items[].productIdentifier
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].packages[].packageId
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].packages[].status
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.shipments[].status
  • If you build this request body, it must now include this field. Requests without it will be rejected.
  • New required field: FulfillmentOrderStatusNotification.Payload.order.status
  • If you build this request body, it must now include this field. Requests without it will be rejected.

🟠 Silent risk (6)

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.

Aplus Content / aplusContent_2020-11-01

  • New enum value(s) in ContentModuleType: BRAND_STORY_ABOUT, BRAND_STORY_FOUR_ASIN, BRAND_STORY_IMAGE_WITH_LOGO, BRAND_STORY_MEDIA_ASSET, BRAND_STORY_QUESTIONS, PREMIUM_COMPARISON_CAROUSEL, PREMIUM_COMPARISON_SCROLLER, PREMIUM_DUAL_IMAGE_TEXT, PREMIUM_FAQ, PREMIUM_FOUR_COLUMN_IMAGES, PREMIUM_FULL_BACKGROUND_IMAGE, PREMIUM_FULL_BACKGROUND_TEXT (+12)
  • 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 ContentType: BrandStory
  • 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.

Vendor Direct Fulfillment Payments / vendorDirectFulfillmentPaymentsV1

  • New enum value(s) in AdditionalDetails.type: LegalTerms, RegulatoryNote, TaxExemptReason
  • 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 TaxRegistrationDetail.taxRegistrationType: LocalTaxNumber
  • 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.

Vendor Invoices / vendorInvoices

  • New enum value(s) in AdditionalDetails.type: LegalTerms, RegulatoryNote, TaxExemptReason
  • 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 TaxRegistrationDetails.taxRegistrationType: LocalTaxNumber
  • 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 (172)

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

Aplus Content / aplusContent_2020-11-01

  • New schema: AsinImage
  • New schema: AsinImages
  • New schema: AssociationType
  • New schema: BrandStoryAboutModule
  • New schema: BrandStoryFourAsinModule
  • New schema: BrandStoryImageWithLogoModule
  • New schema: BrandStoryMediaAssetModule
  • New schema: BrandStoryQuestionsModule
  • New schema: ComparisonFields
  • New schema: ComparisonMetrics
  • New schema: ComparisonProduct
  • New schema: ComparisonProducts
  • New schema: ComparisonRow
  • New optional field: ContentModule.brandStoryAbout
  • New optional field: ContentModule.brandStoryFourAsin
  • New optional field: ContentModule.brandStoryImageWithLogo
  • New optional field: ContentModule.brandStoryMediaAsset
  • New optional field: ContentModule.brandStoryQuestions
  • New optional field: ContentModule.premiumComparisonCarousel
  • New optional field: ContentModule.premiumComparisonScroller
  • New optional field: ContentModule.premiumDualImageText
  • New optional field: ContentModule.premiumFaq
  • New optional field: ContentModule.premiumFourColumnImages
  • New optional field: ContentModule.premiumFullBackgroundImage
  • New optional field: ContentModule.premiumFullBackgroundText

…and 147 more additive changes across 14 models.

📣 Amazon announcements (1)

What Amazon published in its changelog. Link and date; the summary is ours.

⏳ Upcoming removals (next 90 days)

What Amazon removes in the next 90 days according to its official schedule. Not this week's changes: the reminder so the migration does not catch you out.

Removal Product What goes away
11 November 2026 Report Type Values GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE, GET_V2_SETTLEMENT_REPORT_DATA_XML

Sources: the OpenAPI models and the notification, report and feed schemas Amazon publishes, compared version to version; its official deprecations schedule and its changelog. Every change comes from one of these sources: nothing here is a guess.

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 and schemas are © Amazon.com, Inc. or its affiliates, released under the Apache License 2.0. The deprecations schedule and the changelog belong to Amazon's documentation: we link to them and summarize them, never reproduce their content. This newsletter is an independent analysis of those public sources: 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.