The Amazon Selling Partner API (SP-API) enables developers to build applications that help selling partners programmatically exchange data on listings, orders, payments, reports, and more.
Amazon Seller
Amazon Vendor Central
These release notes highlight the latest features, API updates, and documentation improvements. SP-API continues to expand capabilities for sellers and vendors to help drive efficiency and growth.
API Changes
Fulfillment Inbound API v2024-03-20
New feature: View and select one of the available delivery windows for a shipment to arrive at an Amazon facility
New feature: Print labels for individual items
Select Partnered Carrier as an option for your less-than-truckload (LTL) shipments
Update the name of inbound plans and shipments
Update the quantity of units of a SKU after shipment confirmation
Add three new mandatory operations:
confirmDeliveryWindowOptions
,generateDeliveryWindowOptions
, andlistDeliveryWindowOptions
Deprecation Notices
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. For more information about SP-API deprecation dates, refer to the Deprecations table.
The following operations in Fulfillment Inbound API v0 are no longer deprecated:
getShipments
getShipmentItemsByShipmentId
getShipmentItems
May 22, 2024
API Changes
Product Pricing API v2022-05-01
Added the
lowestPricedOffers
andreferencePrices
attributes to provide the top 20 lowest priced offers and reference prices.The Tutorial: Retrieve a list of featured offers for a batch of up to 20 ASINs in the Use Case Guide uses two new attributes:
lowestPricedOffers
andreferencePrices
.Added the Price adjustment automation workflows guide outlining how to leverage the API and Pricing notifications to automate pricing management.
Added the Product pricing API and notifications FAQ.
Catalog Items API v2022-04-01
Added a new
includedData
query parameter optionclassifications
which replaces the deprecated MWSGetProductCategoriesForSKU
andGetProductCategoriesForASIN
operations. Sellers and vendors can useclassifications
to browse classification trees assigned to an ASIN.
Feeds API v2021-06-30
The Order feeds attributes
POST_ORDER_FULFILLMENT_DATA
andPOST_FLAT_FILE_FULFILLMENT_DATA
are updated with a new field:ship-from-supply-source-id
.
Deprecation Notices
Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail beginning on their removal date. Refer to the Deprecations table for dates.
April 24, 2024
API Changes
Orders API v0
Added the
CompanyName
attribute.Updated the rate limit for
getOrder
,getOrderAddress
, andgetOrderBuyerInfo
from .0167 to .5 and increased the burst from 20 to 30.Updated the
IsBuyerRequestedCancel
,IsGift
andNumberOfItems
object types from boolean/integer to string.Updated
getOrders
to returnAutomatedCarrier
andAutomatedShipMethod
attributes.
Easy Ship API v2022-03-23
Updated the license from Amazon Software License to Apache License 2.0.
Added 413 HTTP code to each operation's possible responses.
Report Schema Changes
Added
lastUpdatedDate
field to several Vendor reports.
Vendor Central Marketplace Expansion to Ireland (IE)
On April 23rd, 2024, Vendor Central launched support for Ireland (IE) Marketplace. See SP-API Vendor Central URLs, SP-API Endpoints, and Marketplace IDs for details.
Documentation Changes
The Orders API v0 Use Case Guide now notes orders more than 2 years old are not returned, with some marketplace exceptions.
Deprecation Notices
Deprecated SP-API resources will no longer receive technical support. Calls to deprecated SP-API resources will fail on their removal date. See Deprecations table for details.
Fulfillment Inbound API v0 (Select operations)
Feeds
Notifications
POST_PRODUCT_DATA
and more...
April 1, 2024
API Changes
Fulfillment Inbound v2024-03-20
Early access to the new API which supports FBA Inbound shipment creation and multiple inbound placement service options.
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.
Fulfillment Inbound API v0 (Select operations)
Feeds
March 20, 2024
API Changes
Shipping API v2
Added
AdditionalAddressNotes
,NdrAction
,NdrRequestData
,SubmitNdrFeedbackRequest
to thendrFeedback
parameter.Added tutorial for Using the ndrFeedback API to submit Non-Delivery Reports.
Added
LiquidVolume
,IsHazmat
,DangerousGoodsDetails
attributes to the Item object.
Merchant Fulfillment API v0
Updated to include support for the UK Marketplace Asin Page View Metric report. See Regulatory Compliance Report Type Values.
Reports API v2021-06-30
Added Request and retrieve a bulk invoice report for Multi-Channel Fulfillment (MCF) orders for India tutorial. Allows downloading GST invoices in batch for delivered MCF orders.
Notifications API v1
Updated
FEED_PROCESSING_FINISHED
andREPORT_PROCESSING_FINISHED
to include support for vendors with newaccountId
property. Applies to all marketplaces.
Fulfillment Outbound v2020-07-01
Added
PaymentInformation
attribute, required for India but optional elsewhere.Added tutorial on creating an MCF order for India.
Documentation Changes
Added Python and Javascript SDK client libraries and tutorials.
Reformatted Report Type Values pages and consolidated report type attributes.
Deprecation Notices
Deprecated SP-API resources are no longer in active development. Calls will fail on the removal date. See Deprecations table for details.
Authorization API v1 (All)
FBA Small and Light API v1 (All)
Fulfillment Inbound API v0 (Select)
Feeds
Reports
Notifications
February 21, 2024
API Changes
Reports API v2021-06-30
New Report Type Value EndUserDataReport provides personal customer data for transactions in EU-8 marketplaces.
Application Management API
Promoted from Public Beta to Production. Lets you programmatically rotate LWA credentials.
Documentation Updates
Added six new code tutorials on previewing, creating, and canceling orders.
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.
Feeds
Reports
Notifications
January 31, 2024
API Changes
Listings Items API v2021-08-01
Added validation mode for
putListingsItem
andpatchListingsItem
usingmode=VALIDATION_PREVIEW
to validate without persisting data.Added
ShipsInProductPackaging
toPrepInstruction
enum returned inprepInstructions
response.Added
ExtendedFields
andAddressExtendedFields
for Brazil addresses with extended fields.
Fulfillment By Amazon (FBA) Inventory API
Updated
nextToken
to expire after 30 seconds.
Orders API v0
Added
confirmShipment
operation.Updated
address
attribute to include city.Updated to employ a dynamic sandbox for testing. Includes one new sandbox operation.
Documentation Updates
Added Orders API Use Case Guide for
confirmShipment
.Added Fulfillment Outbound API Dynamic Sandbox use case guide.
Expanded library of reports schemas on GitHub.
Added Listings Items API FAQ, issues troubleshooting, and guidance for complex attributes.
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on their removal date. See Deprecations table for details.
Authorization API v1 (All)
FBA Small and Light API v1 (All)
Feeds
Reports
Notifications
December 13, 2023
API Changes
Application Management API v2023-11-30 Public Beta
New API lets you programmatically rotate LWA credentials.
Shipping API v2
Launched support for dangerous goods (DG) shipping in US and UK.
Listings Items API v2021-08-01
India (IN) now a supported marketplace
Two new fields added to
Issue
object:Enforcements
andCategories
searchDefinitionsProductTypes
updated to string
Notifications API v1
Added optional
payloadVersion
parameter
Documentation Updates
Building Listings Management Workflows Guide updated with steps to retrieve recommendations using
itemName
orkeywords
.Vendor Direct Fulfillment Orders API v1 Use Case Guide updated for customer data transmission. Some fields replaced with
XXXXX
for Amazon label vendors.Vendor Retail Procurement APIs v1 Use Case Guide updated for SubmitShipments and GetShipmentDetails.
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.
Authorization API v1 (All)
FBA Small and Light API v1 (All)
Fulfillment Inbound API v0 (Select)
Merchant Fulfillment API v0 (Select)
Feeds
Reports
Notifications
November 8, 2023
API Changes
Supply Sources API v2020-07-01
New API configures and updates info on seller supply sources like stores and warehouses.
Product Pricing API v2022-05-01
United Kingdom now a valid marketplace.
getFeaturedOfferExpectedPriceBatch
(FOEP) extended to Amazon.co.uk.ASIN_NOT_ELIGIBLE
now a value forresultStatus
.New
competitiveSummary
returns featured buying options summary for ASIN andmarketplaceId
.
Product Type Definitions API v2020-09-01
Updated for 3 new parameters (
itemName
,locale
,searchlocale
) and 1 newdisplayName
product type.
Finances API v0
Updated
ListFinancialEvent
andListFinancialEventGroups
to clarify expected responses and scope.Modified
ChangeRefundTransactions
response from object to array.
Vendor Direct Fulfillment Shipping API v2021-12-28 and v1
Updated
weight
field now mandatory to generate error onshipmentconfirmations
so vendors don't wait for transaction status error.
Documentation Updates
New Multi-Location Inventory (MLI) Integration guide on using APIs for integration with MLI.
Updated Building Listings Management Workflows Guide for retrieving recommendations using
itemName
orkeywords
.
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.
Authorization API v1 (All)
FBA Small and Light API v1 (All)
Fulfillment Inbound API v0 (Select)
Merchant Fulfillment API v0 (Select)
Reports
Notifications
October 11, 2023
API Changes
Listings Items API 2021-08-01
Updated
ItemProcurement
data element from object to array.
Orders API v0
Added list of associated items to
getOrderItems
response.
Product Pricing API v0
Renamed
listingPrice
attribute ingetItemOffers
to help avoid B2B errors.Landedprice
andShipping
now optional.
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.
Authorization API v1 (All)
FBA Small and Light API v1 (All)
Feeds API v2020-09-04 (All)
Fulfillment Inbound API v0 (Select)
Merchant Fulfillment API v0 (Select)
Reports API v2020-09-04 (All)
Notifications
September 20, 2023
API Changes
Orders API v0
Updated
BuyerCompanyName
description to clarify company name of destination address.
Documentation Updates
Building Listings Management Workflows Guide updated for using Listings Items API to create package hierarchies.
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date. See Deprecations table for details.
Authorization API v1 (All)
FBA Small and Light API v1 (All)
Feeds API v2020-09-04 (All)
Fulfillment Inbound API v0 (Select)
Merchant Fulfillment API v0 (Select)
Reports API v2020-09-04 (All)
August 16, 2023
API Changes
Orders API v0
Updated
ShipmentServiceLevelCategory
to includePriority
value for seller-fulfilled Prime in select EU marketplaces. Update integration if needed.
Catalog Items API v2022-04-01
generic_keyword
attribute no longer returned. Use Listings Items API to view submitted values.
Documentation Updates
New Welcome topic with migration/integration resources, search tips, quick links.
New and improved developer registration topics.
Deprecation Notices
Adjusted removal date for Feeds API v2020-09-04 and Reports API v2020-09-04 to Oct 18, 2023. Lower throttle Aug 16 - Oct 18. Calls fail Oct 18. See Deprecations table for details.
June 21, 2023
API Changes
Replenishment API
New API returns selling partner's replenishment metrics and offer info. Available in US, CA, BR, MX, UK, DE, ES, IT, FR, NL, AE, IN, JP, AU.
Reports API
New EPR Monthly, Quarterly, Annual Reports for Extended Producer Responsibility declarations in FR, DE.
New Rapid Retail Analytics reports:
GET_VENDOR_REAL_TIME_SALES_REPORT
- hourly ASIN-level sales dataGET_VENDOR_REAL_TIME_TRAFFIC_REPORT
- hourly detail page traffic dataGET_VENDOR_REAL_TIME_INVENTORY_REPORT
- hourly ASIN-level inventory data
Listings Items API
Now available in Belgium (BE)
Notifications API
New
LISTINGS_ITEM_MFN_QUANTITY_CHANGE
for changes in available quantity of listings itemNew
ORDER_CHANGE
for important order changes. ReplacesORDER_STATUS_CHANGE
.Updated
B2B_ANY_OFFER_CHANGED
to include Quantity Discount pricing inOffer
section.New
ITEM_SALES_EVENT_CHANGE
sent 5 min after each hour with hourly ASIN sales data.New
ITEM_INVENTORY_EVENT_CHANGE
sent 5 min after each hour with hourly ASIN inventory data.New
DETAIL_PAGE_TRAFFIC_EVENT
sent 5 min after each hour with ASIN traffic data from prior hour.
Rapid Retail Analytics
New
MARKETPLACE_ASIN_PAGE_VIEW_METRICS
report on glance view metrics for EU-8 market places.Documentation Updates
New Migrating Listings Management Workflows guide for migrating from XML/flat file feeds to Listings Items API and JSON feeds.
Updated reports schemas repo with
GET_B2B_PRODUCT_OPPORTUNITIES_RECOMMENDED_FOR_YOU
andGET_B2B_PRODUCT_OPPORTUNITIES_NOT_YET_ON_AMAZON
Deprecation Notices
SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls will fail on the removal date.
ORDER_STATUS_CHANGE
MFN_ORDER_STATUS_CHANGE
Feeds API v2020-09-04
Reports API v2020-09-04 See Deprecations table for details.
May 17, 2023
API Changes
Vendor Direct Fulfillment Shipping v2021-12-28
Updated to include
createShippingLabels
synchronous operation to create and return shipping labels for a PO. No sandbox support currently.Updated for production and dynamic sandbox support for all equivalent v1 operations.
Updated restricted operations to support v2021-12-28.
Orders V0
Removed Generic Orders Approvals workflow,
ItemApprovalTypes
, andItemApprovalStatus
.
Documentation Updates
New Reports attributes directory lists available report attributes.
New Vendor Retail Procurement FAQ.
Deprecation Notices
Feeds API v2020-09-04
Reports API v2020-09-04
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
April 19, 2023
API Changes
Fulfillment Outbound API
Updated
city
property inaddress
from required to optional.
Fulfillment By Amazon (FBA) Inventory API
Updated
sellerSku
to parse commas.
Documentation Updates
Amazon Product Type Definition Meta-Schema (v1) updated with new keywords.
Added two new C# guides for SDK generation and authentication.
Deprecation Notices
Feeds API v2020-09-04
Reports API v2020-09-04
March 29, 2023
API Changes
Fulfillment By Amazon (FBA) Inventory API
New error code
PRODUCTASSURANCE_SAFETYDOCUMENTATION
for non-compliant products without safety docs. Returned onCreateInboundShipmentPlan
,CreateInboundShipment
,UpdateInboundShipment
,PreviewItemEligibility
.
Orders API
New
buyerTaxInformation
for Turkey Marketplace with business tax info.
Notifications API
New Order Status Change notification for changes in order availability status.
Reports API
Updated
GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA
report with corrected column names. See FBA Report Types.FBA_BULK_INVOICE report shares seller invoices in date range, including customer orders.
Documentation Updates
New use case directories map APIs, notifications, reports to seller and vendor use cases.
SP-API models table shows API availability for sellers/vendors with links to reference and release notes.
New Vendor Direct Fulfillment Orders v2021-23-28 and Transaction Status v2021-12-28 use case guides.
Updated dynamic usage plans topic for Product Pricing API and
getFeaturedOfferExpectedPriceBatch
.
Deprecation Notices
Feeds API v2020-09-04
Reports API v2020-09-04
FBA Inventory Reports
MFN_ORDER_STATUS_CHANGE
Notification
February 22, 2023
API Changes
Merchant Fulfillment API
Updated to use a dynamic sandbox for testing instead of static. Includes one new sandbox operation.
Orders V0 API
New
buyerRequestedCancel
parameter for buyer cancellation requests and reasons.
Reports API
New Sales and Traffic Business Report with key sales and traffic metrics by date and ASIN. Requires Brand Analytics role, now available to all sellers.
New Coupons Performance Report with campaign and coupon-level promo details. For vendors with Brand Analytics role.
New vendor retail analytics reports, available to vendors with Brand Analytics role:
Vendor Sales Report - key retail sales metrics at aggregate and ASIN level by time period
Vendor Traffic Report - key retail traffic metrics at aggregate and ASIN level by time period
Vendor Forecasting Report - 8 week mean, P70, P80, P90 demand forecasts at ASIN level
Vendor Inventory Health Report 2.0 - inventory and operational metrics at aggregate and ASIN level by time period
Documentation Updates
Documentation update for Flat File and XML Invoice Data Reports for VAT Calculation Service sellers.
New Migration Hub page with MWS to SP-API timelines, deprecation dates, resources.
New SP-API Blog with articles from Amazon experts.
Deprecation Notices
Feeds API v2020-09-04
Reports API v2020-09-04
January 19, 2022
API Changes
Reports API
The new FBA Manage Inventory Health Report has a consolidated view of sales, shipments, fees, aged/excess units, and recommended actions.
A new On Demand Stock Transfer Report with invoice details and GSTINs for interstate movement is needed.
Documentation Updates
Updated Amazon MWS to SP-API Migration Guide with more resources like video series and AWS Quick Start.