SP-API Models
Directory for SP-API models and release notes
The following sections show all Selling Partner APIs (SP-APIs) and indicate whether the API is available for seller or vendor accounts. To identify the APIs, notifications, and reports that you need for specific use cases, refer to SP-API Seller Use Cases and SP-API Vendor Use Cases.
For a complete summary of API updates, refer to SP-API Release Notes. For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
For information about API deprecations, refer to the SP-API Deprecation Schedule.
A+ Content Management API
You use the A+ Content Management API to create and edit A+ Content.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Amazon Warehousing and Distribution API
You can use the Amazon Warehousing and Distribution (AWD) API to create and update inbound orders to ship inventory to AWD distribution centers, track inventory inside AWD distribution centers, and track shipments on the way to AWD distribution centers. For information about AWD API operations, data types, and schemas, refer to the Amazon Warehousing and Distribution API Reference.
App Integrations API
You use the App Integrations API to send notifications to Amazon selling partners and display the notifications in Seller Central.
Release notes
Application Management API
You use the Application Management API to rotate the client secret on registered applications.
Release notes
Catalog Items API
Current version | Legacy versions | Available to sellers | Available to vendors |
---|---|---|---|
v2022-04-01 (Reference | Model) | v0 v2020-12-01 | Yes | Yes |
Customer Feedback API
You use the Customer Feedback API to retrieve insights from customer reviews and returns.
Release notes
Data Kiosk API
You use the Data Kiosk API to submit GraphQL queries for data from a variety of schemas to help selling partners manage their businesses.
Data Kiosk currently hosts Seller Sales and Traffic Data. Find details of the dataset in the schema explorer.
Data Kiosk is available globally in all SP-API Regions, including NA, EU, and FE.
Release notes
Easy Ship API
You use the Easy Ship API to build applications that help you manage and ship Amazon Easy Ship orders. You can schedule or reschedule Easy Ship packages. You can also get invoices, shipping labels, and warranties for scheduled Easy Ship orders.
Release notes
FBA Inbound Eligibility API
You use the FBA Inbound Eligibility API to get eligibility previews for items before you ship the items to Amazon's fulfillment centers.
Release notes
FBA Inventory API
You use the Fulfillment by Amazon (FBA) Inventory API to retrieve information and track the real-time availability of your inventory in Amazon's fulfillment network at the marketplace level. You can get details such as listing condition and inventory quantities such as:
- Fulfillable: Inventory that can be picked, packed, and shipped.
- Inbound: Inventory that is on its way to Amazon's fulfillment network.
- Reserved: Inventory in Amazon's fulfillment network that is being picked, packed, and shipped; or is sidelined for measurement, sampling, or other internal processes.
- Unfulfillable: Inventory that cannot be sold.
- Researching: Inventory that is misplaced or warehouse damaged units that are actively being confirmed at an Amazon fulfillment center.
This API is available in all marketplaces.
Release notes
Feeds API
You use the Feeds API to upload data to Amazon to manage your selling business. There are feeds for a wide variety of use cases, such as creating listings, managing inventory and prices, acknowledging orders, and more. Refer to Feed Type Values for a list of available feed types.
Release notes
Finances API
You use the Finances API to get financial information that is relevant to a seller's business. You can obtain financial events for a specified order or date range without having to wait until a statement period closes. Refer to the Finances API Reference for details about the operations and associated data types in the Finances API.
Release notes
Fulfillment Inbound API
You use the Fulfillment Inbound API to create and update inbound inventory to Amazon's fulfillment network, where Amazon can fulfill your customer's orders. You can also request lists of inbound shipments or inbound shipment items based on criteria you specify. After your inventory has been received in the fulfillment network, Amazon can fulfill your orders regardless of whether you are selling on Amazon's retail website or through other retail channels.
For details about API operations and associated data types and schemas, refer to the Fulfillment Inbound API reference.
Release notes
Fulfillment Outbound API
You use the Fulfillment Outbound API to retrieve information about Multi-Channel Fulfillment (MCF) orders in Amazon's fulfillment network.
Release notes
Invoices API
You use the Invoices API to retrieve and manage invoices and help selling partners manage their bookkeeping.
Important
This API is only able to retrieve Brazilian FBA invoices. You cannot use this API for any other invoice types.
Release notes
Listings Items API
Current version | Legacy versions | Available to sellers | Available to vendors |
---|---|---|---|
v2021-08-01 (Reference | Model) | v2020-09-01 | Yes | Yes |
Listings Restrictions API
<Api_overview_listings_restrictions>
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Merchant Fulfillment API
You use the Merchant Fulfillment API to build applications for sellers to use Amazon Buy Shipping services to purchase shipping for non-Prime and Prime orders.
Release notes
Messaging API
You use the Messaging API to send messages to buyers.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Notifications API
You use the Notifications API to subscribe to notifications that are relevant to your selling business. You can create a destination to receive notifications, subscribe to notifications, delete notification subscriptions, and more. Instead of polling for information, your application can receive information directly from Amazon when an event generates a notification to which you are subscribed.
You can subscribe to notifications on behalf of sellers or vendors. To determine whether you can subscribe to a notification type on behalf of sellers only, vendors only, or both, go to notificationType
. We allow multiple subscriptions with different payload versions per application, notification type and party (seller/vendor). For supported payload versions of different notification types, refer to notificationType
.
Build a backup mechanism
As a best practice, we recommend that you have a means to retrieve needed information in the event of an unexpected outage or delay in notification delivery.
Release notes
Orders API
You use the Orders API to retrieve order information. You can develop custom applications that facilitate order synchronization and order research.
Release notes
Product Fees API
You use the Product Fees API to retrieve estimated fees for a product. You can then account for those fees in your pricing. You can use the getMyFeesEstimates
operation to get product fee estimates for a list of products and marketplaces, and then set prices based on those fee estimates. You must specify your products by ASIN or SKU (not UPC, ISBN, or other identifiers).
You must include an original identifier in each product fees request. This identifier is included in the fees estimate so that you can correlate a fees estimate with an original request.
Important
The estimated fees returned by this API are not guaranteed. Actual fees can vary.
Release notes
Product Pricing API
You use the Product Pricing API to retrieve product pricing and offer information for products in the Amazon catalog. The Product Pricing API is designed to help you develop automated solutions that sellers can use to update and manage their prices. Building in automation for your sellers allows them to react faster to keep their prices competitive and attractive to customers.
Tip
The Product Pricing API supports the development of repricers. Repricers are automated pricing tools that can continuously monitor price points, competitor prices, and other relevant factors in order to adjust a seller's prices in real-time. Repricers use data and insights from Product Pricing and Notifications APIs to help sellers maintain a competitive price advantage.
Release notes
Product Type Definitions API
You use the Product Type Definitions API to search and retrieve attribute and data requirements for product types in the Amazon catalog. Amazon Product Type Definitions describe the attribute and data requirements for items in the Amazon catalog using JSON schemas.
Refer to the Product Type Definitions API v2020-09-01 Reference for details about API operations and associated data types and schemas.
Release notes
Replenishment API
You use the Replenishment API to retrieve information about a selling partner's replenishment program business. Currently, the <<glossary:Subscribe & Save>> replenishment program is supported. With the Replenishment API, you can create applications that return metrics about a selling partner's replenishment business performance and information about their replenishment program offers.
Some attributes or use cases might not be applicable to both sellers and vendors. Refer to the Replenishment API v2022-11-07 reference for details.
The Replenishment API is available wherever Amazon Subscribe & Save is live. The API is also available to vendors and Fulfillment by Amazon (FBA) selling partners.
Release notes
Reports API
You use the Reports API to retrieve and manage reports that you can use to manage your selling business. You can monitor inventory and track orders for fulfillment. You can also get tax information, track returns, and more.
Release notes
- June 25, 2025
- February 26, 2025
- January 29, 2025
- March 20, 2024
- February 21, 2024
- October 11, 2023
- September 20, 2023
- August 16, 2023
- June 21, 2023
- May 17, 2023
- April 19, 2023
- March 29, 2023
- February 22, 2023
- January 25, 2023
- November 9, 2022
- October 19, 2022
- September 21, 2022
- May 18, 2022
- March 23, 2022
- January 19, 2022
Sales API
You use the Sales API to retrieve information about sales performance. You can get aggregated order metrics for a given period of time, broken down by granularity, and buyer type. Refer to the Sales API Reference for details about Sales API operations and associated data types and schemas.
Release notes
Seller Wallet API
You use the Seller Wallet API to retrieve financial information that is relevant to a Seller's Seller Wallet account. You can obtain financial events, balances, and transfer schedules for Seller Wallet accounts. You can also schedule and initiate transactions.
Refer to the Seller Wallet API Reference for details about the operations and associated data types in the Seller Wallet API.
Release notes
Sellers API
You use the Sellers API to retrieve essential information about seller accounts and marketplaces. The returned information includes:
- The marketplaces in which the seller can list items
- The default language and currency of a marketplace
- Whether the seller has suspended listings
- Business information of the seller
For details about the operations, data types, and schemas of the Sellers API, refer to Sellers API v1 Reference.
Release notes
Services API
You use the Services API to get and modify service orders and manage your resources. You can
- Access service job details.
- Confirm or reschedule appointments.
- Set appointment resource assignments.
- Set job fulfillment data.
- Set resource capacity schedules that drive appointment availability for customers.
- Integrate services data for route and fulfillment planning.
After fulfillment, service Sellers can audit resource (for example, technician) performance by tracking on-time start, service job completion within appointment windows, no-shows, and fulfillment breaks.
Post fulfillment, the Services API can measure seller and resource performance, set up payment dashboards for sellers, and analyze the actual demand against resource capacity schedules.
Release notes
Shipment Invoicing API
You use the Shipment Invoicing API to retrieve shipment invoice information for Fulfillment by Amazon (FBA) orders in the Brazil marketplace.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Shipping API
You use the Shipping API to request shipping rates, create shipments, cancel shipments, and track shipments.
Release notes
Solicitations API
You use the Solicitations API to send non-critical solicitations to buyers. You can request both a product review and seller feedback by sending a single template-based email.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Supply Sources API
You use the Supply Sources API to manage the configurations and capabilities of seller supply sources.
Release notes
Tokens API
You use the Tokens API to get a Restricted Data Token (RDT) for restricted resources.
Release notes
Transfers API
You use the Transfers API to initiate payouts to a seller's deposit method on file and retrieve information about the payment instruments that are associated with a seller.
This API supports the following marketplaces:
- Spain
- France
- Belgium
- Netherlands
- Germany
- Italy
- Sweden
- Poland
Release notes
Uploads API
You use the Uploads API to upload files that you can access by using other operations in the SP-API.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Vehicles API
You use the Vehicles API v2024-11-01 to retrieve information about vehicles, including their unique identifiers. You can use this information and the Listings API to provide the list of vehicles with which your listed Amazon Standard Identification Numbers (ASINs) are compatible.
Release notes
Vendor Direct Fulfillment Inventory API
You use the Vendor Direct Fulfillment Inventory API to exchange inventory stock levels with Amazon.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Vendor Direct Fulfillment Orders API
You use the Vendor Direct Fulfillment Orders API to access your direct fulfillment vendor order data. You can receive purchase orders and send order acknowledgments.
Release notes
Vendor Direct Fulfillment Payments API
You use the Vendor Direct Fulfillment Payments API to exchange payment related documents with Amazon.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Vendor Direct Fulfillment Sandbox Test Data API
You use the Vendor Direct Fulfillment Sandbox Test Data API to access vendor direct fulfillment test data in the sandbox.
Release notes
Vendor Direct Fulfillment Shipping API
You use the Vendor Direct Fulfillment Shipping API to access your direct fulfillment vendor shipping data.
Release notes
Vendor Direct Fulfillment Transaction Status API
You use the Vendor Direct Fulfillment Transaction Status API to access your direct fulfillment vendor transaction status.
Release notes
Vendor Invoices API
You use the Vendor Invoices API to access vendor payment data.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Vendor Orders API
You use the Vendor Orders API to access vendor order data.
Release notes
Vendor Shipments API
You use the Vendor Shipments API to access vendor retail shipping data.
Release notes
- December 18, 2024
- For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Vendor Transaction Status API
You use the Vendor Transaction Status API to access status information for specific asynchronous POST transactions for vendors.
Release notes
For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.
Updated about 9 hours ago