HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

SP-API Release Notes

Selling Partner API new features, software updates, and changelog.

For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repo.

December 18, 2024

API changes

Amazon Warehousing and Distribution API v2024-05-09
  • Added the expiration property to the listInventory and getInboundShipment responses. You can use this property to get the expiration date of a perishable item in your shipment. For more information, refer to Track an inbound shipment with expected and received SKU details.
  • Added the prepDetails property to the listInventory and getInboundShipment responses. You can use this property to get the preparation details on an item, including the preparation owner, category, instructions, and label owner.

Data Kiosk API v2023-11-15

  • The Vendor Analytics dataset now includes metrics such as Confirmed Units, Shipped COGS, MSRP, and customer ZIP Code data.

Listings Items API v2021-08-01

  • Added the searchListingsItems operation. You can use this operation to return information for multiple listings items based on filters, which include listing IDs, issues, status, and creation date.

Replenishment API v2022-11-07

  • Added REVENUE_BY_DELIVERIES, SUBSCRIBER_RETENTION, REVENUE_PENETRATION_BY_SELLER_FUNDING, and SHARE_OF_COUPON_SUBSCRIPTIONS metrics to the getSellingPartnerMetrics operation response. These metrics describe the revenue sources and subscription performance.
  • Added the SHARE_OF_COUPON_SUBSCRIPTIONS metric to the listOfferMetrics operation response. This metric describes the coupon acquisition performance.

Sellers API v1

Transfers API v2024-06-01

This API is available in the EU region.

Vendor Direct Fulfillment Shipping API v2021-12-28

  • Added the createContainerLabel operation. You can use this operation to create a container (pallet) label.

Vendor Shipments API v1

  • The GetShipmentLabels operation of the Vendor Shipments API v1 now supports the ability to retrieve small parcel labels for vendors.

Seller Central Marketplace Expansion to Ireland (IE)

On December 10, 2024, Seller Central launched support for the Ireland (IE) Marketplace. For more information, refer to the SP-API Seller Central URLs, SP-API Endpoints, and Marketplace IDs topics in the SP-API documentation.

Third-party provider support for UK and EU SP-API developers

Sellers in the UK and EU can now authorize third-party provider (TPPs) to access an account holder's account and payment services using the AISP and PISP roles.

For more information, refer to Third-Party Provider Registration and Third-Party Provider FAQ.

Documentation changes

Deprecation notices

Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For a complete list of SP-API deprecations, refer to the SP-API Deprecation Schedule.

  • The removal date for select Catalog Items API v0 operations has changed from December 11, 2024 to January 28, 2025. The affected operations are:

    • listCatalogItems
    • getCatalogItem

  • The removal date for the Notifications type value LISTINGS_ITEM_ISSUES_CHANGE (payload version 1.0)has changed from December 11, 2024 to March 26, 2025.

November 14, 2024

API changes

Easy Ship v2022-03-23

November 12, 2024

API changes

Product Pricing API v2022-05-01
  • Added WasPrice to the getCompetitiveSummary operation (in the referencePrices list in the operation response). WasPrice is the 90-day median price that customers pay for the product on Amazon. You can use this value to set promotions and discounts based on the typical price on the product detail page.

November 11, 2024

API changes

Transfers API v2024-06-01
  • Updated the rate limit for the initiatePayout operation from 0.5 to 0.017 and updated the burst rate from 30 to 2.

November 6, 2024

API changes

Finances V0 API
  • Added the TransactionNumber parameter to the AdjustmentItem object. You can use this parameter to identify what the adjustment is related to. For example, Amazon Shipping customers can use this to get an invoice number that they can use to identify an Amazon Shipping invoice.
Fulfillment Outbound API v2020-07-01
  • Added the following to the Fulfillment Outbound API v2020-07-01 Use Case Guide:
    • items now has quantity limitations (maximum of 100 line items with a maximum of 250 units per order).
    • shippingSpeedCategory now has shipping method service-level agreements that vary by marketplace.
    • DeliveryPreferences now has the default delivery preference set to leave the package unattended at the front door for eligible orders.
Merchant Fulfillment API v0
  • Updated the getEligibleShippingServices and createShipment operations to include new increased throttling rates.
Product Pricing API v2022-05-01
  • Added Japan (JP) marketplace support for the getFeaturedOfferExpectedPriceBatch operation. You can now retrieve the Featured Offer Expected Price (FOEP) for all marketplaces.

Documentation changes

Deprecation notices

Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the SP-API Deprecation Schedule.

APIs

  • Catalog Items API v0 (Select operations)

    • listCatalogItems
    • getCatalogItem

  • Fulfillment Inbound API v0 (Select operations)

    • confirmPreorder
    • confirmTransport
    • createInboundShipment
    • createInboundShipmentPlan
    • estimateTransport
    • getPreorderInfo
    • getTransportDetails
    • putTransportDetails
    • updateInboundShipment
    • voidTransport

For more information, refer to Migrating Fulfillment Inbound workflows.

Feeds
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA

For more information, refer to Migrating product feeds workflows.

Notifications
  • LISTING_ITEM_ISSUES_CHANGE payload version 1.0

October 14, 2024

API changes

Fulfillment Inbound API v2024-03-20
Notifications API v1
  • Added the TRANSACTION_UPDATE notification that is sent whenever there is a new transaction posted to the seller's account.

Documentation changes

September 25, 2024

API changes

Data Kiosk API v2023-11-15
  • Added GroupByAttributes to the analytics_vendorAnalytics_2024_09_30 schema. These attributes detail the location to which items are shipped:
    • shipToCountryCode
    • shipToCity
    • shipToStateOrProvince
FBA Inventory API v1
  • Updated the GetInventorySummariesResponse to include a new Stores array. Stores contains a list of seller-enrolled stores for the affected inventory item.
Notifications API v1
Finances API v0
  • Added the optional storeName field to listFinancialEvents response. This field provides the store where the transaction took place, and is contained in the following objects:
    • ShipmentEvent
    • PayWithAmazonEvent
    • ServiceFeeEvent
    • RemovalShipmentEvent
Finances API v2024-06-19
  • New Finances API v2024-06-19 provides financial information that is relevant to a seller's business. You can use this API to obtain financial events for a specified order or date range without having to wait until a statement period closes.
Invoices API v2024-06-19
Orders API v0
  • Added the AmazonPrograms attribute to the getOrderItems response. This attribute contains the list of programs that are associated with an item, such as Subscribe and Save.

Documentation changes

Deprecation notices

Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the SP-API Deprecation Schedule.

APIs

  • Catalog Items API v0 (Select operations)

    • listCatalogItems
    • getCatalogItem

  • Fulfillment Inbound API v0 (Select operations)

    • confirmPreorder
    • confirmTransport
    • createInboundShipment
    • createInboundShipmentPlan
    • estimateTransport
    • getPreorderInfo
    • getTransportDetails
    • putTransportDetails
    • updateInboundShipment
    • voidTransport

For more information, refer to Migrating Fulfillment Inbound workflows.

Feeds
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA

For more information, refer to Migrating product feeds workflows.

Notifications
  • LISTING_ITEM_ISSUES_CHANGE payload version 1.0

September 11, 2024

API changes

EasyShip API v2022-03-23
Fulfillment Outbound API v2020-07-01
  • Added an optional field, deliveryInformation, to the GetFulfillmentOrder response. You can use this to get the deliveryDocumentList, which can have a photo or signature for a delivered Multi-Channel Fulfillment Outbound shipment. You can use dropOffLocation to get where the shipment package was delivered.
Listings Items API v2021-08-01
Orders API v0
  • Added new optional verification details properties to the regulatedInfo operations. Sellers can use these details to verify orders that contain prescriptions.
  • The Regulated orders guide includes a new tutorial on how to provide additional details about the verification of an order that contains regulated information.
Product Pricing API v2022-05-01
  • Updated the getFeaturedOfferExpectedPriceBatch to no longer require offerIdentifier in the FeaturedOfferExpectedPriceResponseBody. The offerIdentifier parameter is now optional in order to correctly deserialize getFeaturedOfferExpectedPriceBatch error responses, as FeaturedOfferExpectedPriceResponseBody doesn’t provide offerIdentifier in the response when there are errors.

Deprecation notices

Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the SP-API Deprecation Schedule.

August 19, 2024

API changes

Amazon Warehousing and Distribution API v2024-05-09
  • Added the optional response parameter totalInboundQuantity to the listInventory operation. You can use this parameter to track inventory in transit to Amazon Warehousing and Distribution.
  • Added a new optional request parameter skuQuantities to the getInboundShipment operation. You can use this parameter to reconcile and compare expected and received inventory for each SKU in a shipment.

You can now use the Amazon Warehousing and Distribution API to:

  • Track inventory in-transit to Amazon Warehousing and Distribution to improve end-to-end inventory view.
  • Reconcile and compare expected and received inventory for each SKU in a shipment.

August 14, 2024

API changes

FBA Inbound Eligibility API v1
  • Added a new inbound ineligibility enum value, FBA_INB_0342 in the getItemEligibilityPreview operation. This value provides more information on why an offer can't use certain manufacturer barcodes.
Sellers API v1
  • Added the getAccount operation to retrieve information about seller accounts.
Vendor Orders API v1

Documentation changes

Deprecation notices

Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the deprecations table.

The following operations in the Catalog Items API v0 were deprecated on September 30, 2022 and will be removed on September 25, 2024:

  • listCatalogItems
  • getCatalogItem

July 31, 2024

API changes

Fulfillment Outbound API v2020-07-01

  • Added the queryStartDate parameter to the getFeatureInventory operation. You can use this parameter to select inventory that has been updated since a specified date.

  • The Fulfillment Outbound API v2020-07-01 Use Case Guide provides steps on how to pass the queryStartDate parameter when retrieving a list of inventory items that are eligible for a specified fulfillment feature.

Documentation changes

The Selling Partner API Blog will be removed on July 31, 2024. For technical guidance on Selling Partner APIs, refer to the SP-API Documentation site. For supplementary guidance on Selling Partner APIs, refer to Developer University.

Deprecation notices

Deprecated SP-API resources are no longer in active development. Calls to deprecated SP-API resources will fail as of their removal date. For more information about SP-API deprecation dates, refer to the deprecations table.

The following operations in the Catalog Items API v0 were deprecated on September 30, 2022 and will be removed on September 25, 2024:

  • listCatalogItems
  • getCatalogItem

July 8, 2024

API changes

Merchant Fulfillment v0 API
  • Added the Benefits object, which contains a list of included and excluded Amazon benefits from a shipping service offer. Each excluded benefit has a list of reason codes for why it is excluded. Benefits represent services provided by Amazon (for example, CLAIMS_PROTECTED for A-to-z Guarantee) when sellers purchase shipping through Amazon. Sellers gain insight into what comes with buying a label through Amazon.

June 28, 2024

API changes

June 27, 2024

API changes

Fulfillment Inbound API v2024-03-20
Transfers API v2024-06-01

Documentation changes

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.

June 19, 2024

API changes

Amazon Warehousing and Distribution API v2024-05-09
Data Kiosk API v2023-11-05
  • The Data Kiosk API v2023-11-05 is now in general availability.
  • The new Data Kiosk sample solution provides all the resources that you need to deploy a fully functional SP-API application that automates the creation and retrieval of Data Kiosk documents.
  • The new Data Kiosk workflow guide offers insights into best practices, answers common questions about API usage, and outlines optimal workflows.
  • The new Vendor Analytics dataset provides vendor data across multiple domains. You can aggregate data across any granularity (ASIN/Brand/Manufacturing/date) and access more than 100 metrics across sales, traffic, inventory, forecast, profitability, and new geographic sales metrics.
FBA Inventory API v1
Fulfillment Outbound API v2020-07-01
  • Added the new deliveryOffers operation. Sellers can use this operation to display Multi-Channel Fulfillment (MCF) standard delivery offers on pre-checkout pages. This operation is only available in the United States (US) marketplace.
  • Added the optional field lockerDetails to the getFulfillmentOrder response. Sellers can include the information that is needed to access the locker delivery boxes. This field is only available in the Japan (JP) marketplace.
  • Added the optional field deliveryPreferences to the createFulfillmentOrder request. Sellers can include the delivery preferences that are applied to the destination address. This field is only available in the Japan (JP) marketplace.
  • Developers who create or manage applications that integrate with the FBA Inventory API v1 and Fulfillment Outbound API v2020-07-01 can use the two dynamic sandbox environments to test code integrations between the FBA and Fulfillment Outbound API domains. These sandboxes simulate order fulfillment and inventory movements that mimic Amazon's production responses. For more information, refer to the Fulfillment Outbound Dynamic Sandbox Guide.
Product Pricing API v2022-05-01
  • The getFeaturedOfferExpectedPriceBatch operation is now available in all marketplaces except Japan (JP). Sellers can use this operation to get the featured offer expected price (FOEP) data for up to 40 SKUs.
Replenishment API v2022-11-07
  • Added the metrics LOST_REVENUE_DUE_TO_OOS, SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS, and COUPONS_REVENUE_PENETRATION to the getSellingPartnerMetrics operation response. These metrics describe sources of revenue and lost revenue.
  • Added the metrics LOST_REVENUE_DUE_TO_OOS and COUPONS_REVENUE_PENETRATION to the listOfferMetrics operation response. These metrics describe sources of revenue and lost revenue.

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.

June 4, 2024

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, and listDeliveryWindowOptions

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:

May 22, 2024

API changes

Product Pricing API v2022-05-01
Catalog Items API v2022-04-01
  • Added a new includedData query parameter option called classifications, which replaces the deprecated MWS GetProductCategoriesForSKU and GetProductCategoriesForASINoperations. Sellers and vendors can use classifications to browse the classification trees assigned to an ASIN.
Feeds API v2021-06-30

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.

April 24, 2024

API changes

Orders API v0

  • Added the CompanyName attribute to the Orders API v0 API.

  • Updated the rate limit for the getOrder, getOrderAddress, and getOrderBuyerInfo operations from .0167 to .5 and increased the burst from 20 to 30.

  • Updated the IsBuyerRequestedCancel, IsGift and NumberOfItems object types from Boolean/integer to string.

  • Updated the getOrders operation to return the AutomatedCarrier and AutomatedShipMethod attributes.

Easy Ship API v2022-03-23
  • Updated the license from the Amazon Software License to the Apache License 2.0.
  • Added the 413 HTTP code to each operation’s list of possible responses.

Report schema changes

Added The lastUpdatedDate field to the following Vendor reports:

Vendor Central Marketplace Expansion to Ireland (IE)

On April 23rd, 2024, Vendor Central launched support for Ireland (IE) Marketplace. For more information, refer to the SP-API Vendor Central URLs, SP-API Endpoints, and Marketplace IDs topics in the SP-API documentation.

Documentation changes

  • The Orders API v0 Use Case Guide includes new details about order age. Orders more than two years old will not be returned in the API response. The JP, AU, and SG marketplaces are an exception. In those marketplaces the Orders API v0 supports orders from 2016 to present.

Deprecation notices

Deprecated SP-API resources will no longer receive technical support. Calls to deprecated SP-API resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Fulfillment Inbound API v0 (Select operations)
    • createInboundShipmentPlan
    • updateInboundShipment
    • createInboundShipment
    • getPreorderInfo
    • confirmPreorder
    • getTransportDetails
    • putTransportDetails
    • voidTransport
    • estimateTransport
    • confirmTransport
    • getShipments
    • getShipmentItemsByShipmentId
    • getShipmentItems
Feeds
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA
Notifications
  • LISTING_ITEM_ISSUES_CHANGE payload version 1.0

April 1, 2024

API changes

Fulfillment Inbound v2024-03-20
  • Early access to the new Fulfillment Inbound v2024-03-20 API, which supports FBA Inbound shipment creation and allows you to select from multiple inbound placement service options, among other features.

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Fulfillment Inbound API v0 (Select operations)
    • createInboundShipmentPlan
    • updateInboundShipment
    • createInboundShipment
    • getPreorderInfo
    • confirmPreorder
    • getTransportDetails
    • putTransportDetails
    • voidTransport
    • estimateTransport
    • confirmTransport
    • getShipments
    • getShipmentItemsByShipmentId
    • getShipmentItems

March 20, 2024

API changes

Shipping API v2
Merchant Fulfillment API v0
  • Added the Dangerous Goods attributes LiquidVolume, IsHazmat, and DangerousGoodsDetails to the Item object.
Reports API v2021-06-30
Notifications API v1
  • Updated FEED_PROCESSING_FINISHED and REPORT_PROCESSING_FINISHED to include support for vendors. Both notifications include a new accountId property, which identifies the selling partner on whose behalf the feed or report was submitted. This change applies to all marketplaces.
Fulfillment Outbound v2020-07-01

Documentation changes

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 detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Authorization API v1 (All operations)
  • FBA Small and Light API v1 (All operations)
  • Fulfillment Inbound API v0 (Select operations)
    • getInboundGuidance
Feeds
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA
  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED
Reports
  • GET_PRODUCT_EXCHANGE_DATA
  • GET_FBA_UNO_INVENTORY_DATA
Notifications
  • MFN_ORDER_STATUS_CHANGE
  • LISTING_ITEM_ISSUES_CHANGE payload version 1.0

February 21, 2024

API changes

Reports API v2021-06-30
  • Added new Report Type Value EndUserDataReport provides personal customer data, including contact information, Glance View, and Orderdata for customers who have elected to share this data with the seller when completing a transaction in DE, FR, IT, ES, NL, PL, SE and BE (EU-8) marketplaces.
Application Management API
  • Promoted the Application Management API v2023-11-30 from Public Beta to Production. This API lets you programmatically rotate your Login with Amazon (LWA) credentials (client secrets).

Documentation updates

  • Added six new code tutorials that detail how to do various tasks such as previewing orders, creating orders, and canceling orders. Find them in the Code Samples section.

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

Feeds
  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED
Reports
  • GET_PRODUCT_EXCHANGE_DATA
  • GET_FBA_UNO_INVENTORY_DATA
Notifications
  • MFN_ORDER_STATUS_CHANGE

January 31, 2024

API changes

Listings Items API v2021-08-01
  • Added a new validation mode for the putListingsItem and patchListingsItem operations. Use the mode=VALIDATION_PREVIEW query parameter to validate a listings item without persisting the data in the catalog. This feature allows you to preview listing errors in production without creating listings.
Fulfillment Inbound API v0
  • Added the ShipsInProductPackaging value to the PrepInstruction enum. PrepInstructionList is returned in the response for calls to prepInstructions.
Orders API v0
  • Added ExtendedFields and AddressExtendedFields objects. These objects are only available for Brazil addresses and are returned in responses for a Brazil shipping addresses that contain extended fields.

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Authorization API v1 (All operations)
  • FBA Small and Light API v1 (All operations)

Feeds

  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED

Reports

  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA

December 13, 2023

API changes

Application Management API v2023-11-30 Public Beta
  • New Application Management API lets you programmatically rotate your Login with Amazon (LWA) credentials (client secrets). Available in public beta.
Shipping API v2
  • Launched support for dangerous goods (DG) shipping in the US and UK markets.
Listings Items API v2021-08-01
  • India (IN) is now a supported marketplace
  • Two new fields added to the Issue object: Enforcements and Categories
Product Type Definitions API v2020-09-01
  • searchDefinitionsProductTypes operation type updated to string
Notifications API v1

Documentation updates

Vendor Direct Fulfillment Orders API v1 Use Case Guide was updated to include a section on Direct Fulfillment customer data transmission. Vendors do not receive customer data such as name, address, or phone number for certain shipments fulfilled through the getOrder and getOrders operations. For Amazon label only vendors, certain fields will be replaced with the fictitious value XXXXX.

The Vendor Retail Procurement APIs v1 Use Case Guide has been updated to include information on using the Operations SubmitShipments and GetShipmentDetails.

GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA now includes updated column names. A note has been added to the FBA Long Term Storage Fee Charges Report on the Fulfillment by Amazon (FBA) Report Type Values page, outlining the correct way to generate the report.

The Fulfillment by Amazon (FBA) bulk invoice report (FBA_BULK_INVOICE) shares the invoices for a seller within the given date range. These invoices include customer orders served by the seller.

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Authorization API v1 (All operations)
  • FBA Small and Light API v1 (All operations)
  • Fulfillment Inbound API v0 (Select operations)
    • getInboundGuidance
  • Merchant Fulfillment API v0 (Select operations)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
Feeds
  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED
Reports
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA
Notifications
  • ORDER_STATUS_CHANGE

November 8, 2023

API changes

Supply Sources API v2020-07-01
  • New Supply Sources API configures and updates information on seller supply sources, such as stores and warehouses.
Product Pricing API v2022-05-01
  • The United Kingdom is now a valid marketplace.
  • getFeaturedOfferExpectedPriceBatch(FOEP) has been extended to Amazon.co.uk.
  • ASIN_NOT_ELIGIBLE is now a value for resultStatus.
  • The new competitiveSummary operation returns the competitive summary response including featured buying options for the ASIN and marketplaceId combination.
Product Type Definitions API v2020-09-01
  • Updated for three new parameters (itemName, locale, and searchlocale) and one new displayName product type.
Finances API v0
  • Updated ListFinancialEvent and ListFinancialEventGroups operations more clearly communicate expected responses and scope. The response for ChangeRefundTransactions was modified from an object to an array.
Vendor Direct Fulfillment Shipping API v2021-12-28 and v1
  • Updated weight field is now mandatory. This change will generate an error when invoking shipmentconfirmations so that vendors do not have to wait for an error during transaction status.

Documentation updates

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Authorization API v1 (All operations)
  • FBA Small and Light API v1 (All operations)
  • Fulfillment Inbound API v0 (Select operations)
    • getInboundGuidance
  • Merchant Fulfillment API v0 (Select operations)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
Reports
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA
Notifications
  • ORDER_STATUS_CHANGE

October 11, 2023

API changes

Listings Items API 2021-08-01
  • Updated ItemProcurement data element changed from object to an array.
Orders API v0
  • A list of associated items was added to the response for the getOrderItems operation.
Product Pricing API v0
  • The listingPrice attribute in the getItemOffers response was renamed to help developers avoid errors when extending their code for business-to-business use cases. The Landedprice and Shipping sub-fields are no longer required, but optional.

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Authorization API v1 (All operations)
  • FBA Small and Light API v1 (All operations)
  • Feeds API v2020-09-04 (All operations)
  • Fulfillment Inbound API v0 (Select operations)
    • getInboundGuidance
  • Merchant Fulfillment API v0 (Select operations)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
  • Reports API v2020-09-04 (All operations)
Reports
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA
Notifications
  • ORDER_STATUS_CHANGE

September 20, 2023

API changes

Orders API v0
  • The BuyerCompanyName operation description in the Orders v0 API has been updated to clarify the company name of the destination address.

Documentation updates

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs
  • Authorization API v1 (All operations)
  • FBA Small and Light API v1 (All operations)
  • Feeds API v2020-09-04 (All operations)
  • Fulfillment Inbound API v0 (Select operations)
    • getInboundGuidance
  • Merchant Fulfillment API v0 (Select operations)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
  • Reports API v2020-09-04 (All operations)
Reports
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA

August 16, 2023

API changes

Orders API v0
  • The ShipmentServiceLevelCategory property of the order definition has been updated to include the value Priority. This value is available from the new shipping template available in the France, Spain, Germany, Poland, Netherlands, Sweden, and Belgium marketplaces to support seller-fulfilled Prime orders. If your integration uses the new shipping templates for these regions, you might need to update your integration to accept the Priority value for ShipmentServiceLevelCategory.
Catalog Items API v2022-04-01
  • The generic_keyword attribute is proprietary seller-specific data and will no longer be returned by the Catalog Items API. Selling Partners can use the Listings Items API to view submitted values.

Documentation updates

Deprecation notices

We have adjusted the removal date for the following APIs:

Calls to these APIs will have a lower throttle rate from Aug 16, 2023-* through October 18, 2023. Calls to these APIs will fail on October 18, 2023.

For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

June 21, 2023

API changes

Replenishment API
  • New Replenishment API v2022-11-07 returns a selling partner's replenishment program (Subscribe & Save) metrics and offer information. This API is available in the following marketplaces: United States of America, Canada, Brazil, Mexico, United Kingdom, Germany, Spain, Italy, France, Netherlands, United Arab Emirates, India, Japan, and Australia.
Reports API
  • New MARKETPLACE_ASIN_PAGE_VIEW_METRICS report provides information on the ASIN page view (glance view) metrics for the DE, FR, IT, ES, NL, PL, SE and BE (EU-8) marketplaces, with data available up to the last seven days.
Rapid Retail Analytics
Listings Items API
Notifications API
  • New LISTINGS_ITEM_MFN_QUANTITY_CHANGE notification is sent whenever there is change in the available quantity of a listings item.
  • New ORDER_CHANGE notification is sent whenever there is an important change in the order. Important changes include order status changes and buyer requested cancellations. This notification replaces ORDER_STATUS_CHANGE.
  • The B2B_ANY_OFFER_CHANGED notification has been updated to include the Quantity Discount (QD) pricing in the Offer section, with new attributes including multiple quantity tiers, discount type, and price. You can now use this notification to build QD re-pricing solutions, which eliminates the need to use pricing APIs for this purpose.
Rapid Retail Analytics
  • New ITEM_SALES_EVENT_CHANGE notification is sent five minutes after the beginning of each hour. This notification shares sales data at an ASIN level and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included when they have orders or cancellations during a given hour. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
  • New ITEM_INVENTORY_EVENT_CHANGE notification is sent five minutes after the beginning of each hour. This notification shares inventory data at an ASIN level, and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included if the number of units available for purchase by customers has changed. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.
  • New DETAIL_PAGE_TRAFFIC_EVENT notification is sent five minutes after the beginning of each hour. This notification shares traffic data at an ASIN level and includes data for the hour before the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs that have glance views are included. Each notification can include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.

Documentation updates

Deprecation notices

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their removal date

For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

May 17, 2023

API changes

Vendor Direct Fulfillment Shipping v2021-12-28
  • Updated the dynamic sandbox to include the createShippingLabels operation.
Orders V0
  • Remove the Generic Orders Approvals workflow. Removed ItemApprovalTypes and ItemApprovalStatus attributes.

Documentation updates

Deprecation notices

April 19, 2023

API changes

Fulfillment Outbound API
  • Updated the city property in the address attribute from required to optional.
Fulfillment By Amazon (FBA) Inventory API
  • Updated the sellerSku field to include and parse commas.

Documentation updates

Product Type Definition Meta Schema
  • The Amazon Product Type Definition Meta-Schema (v1) has been updated to include the following keywords: $lifecycle, replacedBy, replaces, enumDeprecated, and enumReplacement.
C# guide updates

Deprecation notices

March 29, 2023

API changes

Fulfillment By Amazon (FBA) Inventory API
  • Update nextToken to expire after 30 seconds.
Orders API
  • Added confirmShipment operation.
Fulfillment Outbound API
  • Updated address attribute to include city.
  • Updated to employ a dynamic sandbox for testing instead of a static sandbox. Includes one new sandbox-only operation.

Documentation updates

Deprecation notices

February 22, 2023

API changes

Merchant Fulfillment API
  • Updated static sandbox mock responses to display names of select UPS domestic (US) ship methods on SP-API.
Orders V0 API
  • Added the following delivery preferences attributes to getOrderAddress to support Amazon Business customer orders:
    • PreferredDeliveryTime
    • BusinessHours
    • OtherAttributes
    • AddressInstructions

These attributes contain information about how and when a package is delivered.

Vendor Direct Fulfillment Orders API
  • The customedURL attribute of buyerCustomizedInfo, returned by the getOrder and getOrders operations, is now a Base 64 encoded URL using the UTF-8 character set.
Vendor Retail Procurement Orders API
  • Updated to pass six-month-past-in-date as a query parameter.

Documentation updates

  • New Amazon Business Orders Use Case Guide introduces operations to obtain information about Amazon Business customers and their delivery preferences.
  • New Sales API Use Case Guide provides sellers with sales performance information. This is achieved through returning aggregated order metrics for a given period of time, broken down by granularity, and buyer type.
  • New FBA Small & Light Use Case Guide introduces operations to help access the Small and Light FBA program.

Deprecation notices

January 25, 2023

API Changes

Product Pricing API
  • New getFeaturedOfferExpectedPriceBatch operation retrieves responses to a batch of up to 40 featured offer expected price (FOEP) requests.
Vendor Direct Fulfillment Orders API
  • New buyerCustomizedInfo attribute, containing buyer information for products the vendor has configured as customizable, specifying the types of customization or configurations along with types and ranges for their product.
Orders API
  • New serialNumber attribute returns a list of serial numbers for electronic products that are shipped to customers. Returned for FBA orders only.
Finances API
  • New financial event type: CapacityReservationBillingEventList allows you to retrieve details related to a Capacity Reservation Billing charge.

Documentation updates

Deprecation notices

December 6, 2022

API Changes

Catalog Items API

The Catalog Items v2022-04-01 API has been updated to include several additional attributes in the summary to bring the Catalog Items API to parity with the Marketplace Web Services Catalog Items section:

In addition, the following attributes have been added to ItemSummaryByMarketplace:

  • adultProduct
  • autographed
  • memorabilia
  • releaseDate
  • tradeInEligible

November 9, 2022

API Changes

Reports API

  • New GST Merchant Tax Report B2B GET_GST_MTR_B2B_CUSTOM provides detailed information about sales, refunds, and cancellations from Amazon Business invoices issued within a date range that you specify. Only available in the India Marketplace.

  • New GST Merchant Tax Report B2C GET_GST_MTR_B2C_CUSTOM provides detailed information about sales, refunds, and cancellations from consumer invoices issued within a date range that you specify. Only available in the India Marketplace.

  • New GST Merchant Stock Transfer Report GET_GST_STR_ADHOC provides details on inventory movements from Amazon fulfillment centers (FC) (FC removals or FC-to-FC transfers). The report contains transaction level details required for accounting and GST tax filing. Only available in the India Marketplace.

Documentation updates

October 19, 2022

API Changes

Notifications API

Updated for new FBA_INVENTORY_AVAILABILITY_CHANGES notification that is sent whenever there is a change in the Fulfillment By Amazon (FBA) inventory quantities. This notification includes a snapshot of the FBA inventory in all eligible marketplaces in a particular region.

Reports API

  • Updated GET_SALES_AND_TRAFFIC_REPORT, which now includes B2B traffic data regarding traffic originating from Amazon Business customers. As of 08/28/2022 B2B conversion metrics have changed to use the new B2B traffic data. Data before 08/28/2022 is set to zero to avoid confusion.

  • New Subscribe and Save Forecasting report GET_FBA_SNS_FORECAST_DATA provides an eight-week forecast of sales based on existing subscriptions and sales history.

  • New Subscribe and Save Performance report GET_FBA_SNS_PERFORMANCE_DATA provides a trailing four-week view of items shipped, percentage of orders missed due to being out of stock, average post-discount sale price, and average discount for each SKU.

Documentation updates

September 21, 2022

API Changes

Vendor Direct Fulfillment Shipping API v2021-12-28
  • Updated for new createShippingLabels synchronous operation that creates shipping labels for a purchase order and returns the labels. Note that the createShippingLabels operation does not have any sandbox support at this time.
  • Updated for production and dynamic sandbox support for all of the equivalent Vendor Direct Fulfillment Shipping V1 operations.
Tokens API v2021-03-01
  • Updated for the following restricted operations to support Vendor Direct Fulfillment Shipping API v2021-12-28:
    • createShippingLabels
    • getPackingSlip
    • getCustomerInvoice
    • getShippingLabel
Reports API v2021-06-30
  • Updated Inventory Ledger Report (GET_LEDGER_DETAIL_VIEW_DATA) now includes a new eventType filter to filter on particular warehouse events.

Documentation updates

August 10, 2022

API Changes

Orders V0 API
  • Improvements to the Orders API in support of Easy Ship shipments.
Services V1 API
  • Updated for new getRangeSlotCapacity operation that provides capacity slots in a format similar to availability records.
  • Updated for new getFixedSlotCapacity operation that provides fixed capacity slots.

May 18, 2022

API Changes

Catalog Items API
  • New Catalog Items API version 2022-04-01 improves the API experience and addresses developer feedback with the following changes:
    • Added identifier-based searches to the searchCatalogItems operation, enabling batch-like requests with up to 20 identifiers per request (such as ASINs, UPCs, and EANs)
    • Added dimensions data set, providing normalized item and package dimensions
    • Added display names for product category, product subcategory, and browse classification
    • Expanded identifying attributes to item summaries (item classification, package quantity, part number, website display group)
    • Added browse classifications and website display groups to sales ranks
    • Aligned searchCatalogItems and getCatalogItem operations to use the same data sets, including attributes
    • Replaced variations with relationships to allow for multiple relationship types to be represented, such as package hierarchies
    • Added variation theme details (name to the relationships details)
Notifications API
  • Added a processingDirective parameter that lets you pass additional information to the subscription to control the processing of notifications. This parameter is used by the ANY_OFFER_CHANGED notification.
  • Updated the ANY_OFFER_CHANGED notification to support filtering notifications to only specific marketplaceIds, and limiting notifications to one every five or ten minute interval.
Orders API
  • Updated to include support for the Purchase Shield program that manages regulated orders in the UK. Regulated orders are a limited set of orders that fulfill products requiring a prescription (pet medication, prescription contacts, and prescription glasses). Two new operations have been added: getOrderRegulatedInfo and updateVerificationStatus.
  • New IsAccessPointOrder attribute to support identifying MFN (fulfilled by seller) orders that have been shipped to access point (AP) hubs.
Product Fees API
  • Updated for new getMyFeesEstimates operation that retrieves product fee estimates for a list of products and marketplaces.
Product Pricing API
  • Updated for new getItemOffersBatch and getListingOffersBatch operations that retrieve product pricing and offer information in a list for products.
Reports API

April 13, 2022

API Changes

Easy Ship API
  • New Easy Ship API helps you build applications that help sellers manage and ship Amazon Easy Ship orders.
FBA Inventory API
  • Updated FBA Inventory API for global availability and released new FBA Inventory Use Case Guide.
Notifications API
  • New PRICING_HEALTH notification is sent whenever a seller offer is ineligible to be the Featured Offer (Buy Box offer) because of an uncompetitive price.
  • New FulfillmentChannel property in the ORDER_STATUS_CHANGE notification that allows you to filter order status change notifications based on whether the order is fulfilled by Amazon (AFN) or fulfilled by seller (MFN).
Vendor Direct Fulfillment APIs

Documentation updates

March 23, 2022

API Changes

Orders API
  • New buyerRequestedCancel parameter provides information on whether a buyer requested order cancellation and reason for cancellation.
Reports API

New Seller retail analytics reports

  • New Sales and Traffic Business Report helps you manage your analytics better by providing key sales performance metrics such as ordered product sales, revenue, units ordered, and claim amount, as well as page traffic metrics such as page views and buy box percentage of the seller’s entire catalog of items aggregated by date and ASIN. This report requires the Brand Analytics Selling Partner API role which is now available to all sellers.

New Performance reports

  • New Coupons Performance Report helps you optimize your promotions and adjust your advertising strategies. The report includes campaign-level details (total clips, redemptions) and coupon-level details (start/end date, clips, redemptions, and budget information). Available to vendors who have the Brand Analytics Selling Partner API role.

New Vendor retail analytics reports

  • New Vendor Sales Report helps you manage your inventory better by providing key retail sales metrics such as ordered/shipped revenue and units. Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across DAY, WEEK, MONTH, QUARTER, and YEAR reporting periods. Available to vendors who have the Brand Analytics Selling Partner API role.
  • New Vendor Traffic Report helps you manage your inventory better by providing key retail traffic metrics such as detail page views. Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across DAY, WEEK, MONTH, QUARTER, and YEAR reporting periods. Available to vendors who have the Brand Analytics Selling Partner API role.
  • New Vendor Forecasting Report helps you manage your inventory better by providing forward looking mean, P70, P80, and P90 weekly customer demand forecasts. The forecasting system produces forecasts for an ASIN at various P-levels, also known as confidence levels. If you are setting a forecasting P-level of .80 ("P80"), it means that there is an 80% probability customer demand will not exceed the weekly forecasted units. Data is reported at the ASIN level for the most recent weekly forecast generation date. Available to vendors who have the Brand Analytics Selling Partner API role.
  • New Vendor Inventory Health Report 2.0 helps you manage your inventory better by providing inventory and operational health metrics such as sellable on hand units and vendor confirmation rate. Data is reported at the aggregate level across a vendor's catalog of items and at the ASIN level across week, month, quarter, and year reporting periods. Available to vendors who have the Brand Analytics Selling Partner API role.

Documentation update for Invoice data reports

  • Flat File VAT Invoice Data Report and XML VAT Invoice Data Report are now available in documentation. These reports are for sellers enrolled in Amazon’s VAT Calculation Service and who opt to upload their own invoices.

Documentation updates

  • New Migration Hub page aggregates all Amazon MWS to Selling Partner API migration-related timelines, planned deprecation dates, and resources into a single reference page.

  • New Selling Partner API Blog site includes articles from Amazon Solutions Architects and API experts covering a range of topics including customer stories, migration, best practices, tips and tricks, and much more.

January 19, 2022

API Changes

Fulfillment Inbound

  • New error code PRODUCTASSURANCE_SAFETYDOCUMENTATION returned for non-compliant products that do not have safety compliance documentation. This error code is returned for the following operations:
    • CreateInboundShipmentPlan
    • CreateInboundShipment
    • UpdateInboundShipment
    • PreviewItemEligibility

Read more about this change on Seller Central.

Orders API

  • New buyerTaxInformation attribute for the Turkey Marketplace. This attribute includes business tax information when the buyer is a business.

Notifications API

  • New Order Status Change notification is sent whenever there is a change in the status of order availability.

Reports API

  • New FBA Manage Inventory Health Report helps you manage your inventory better by providing a consolidated view across your sales (7, 30, 60, and 90 days), shipment statuses (working, received, and shipped), estimated storage and long-term storage fees, and aged and excess units. This report includes metrics across sales, inbound, estimated fees, and recommended actions.
  • New On Demand Stock Transfer Report that provides transaction level information like invoice value, invoice number, tax rate, and Goods and Services Tax Identification Numbers (GSTINs) for interstate movement transactions.

Documentation updates

Amazon MWS to Selling Partner API Migration Guide

Updated 5 days ago