Jump to Content
Selling Partner API
HomeDocumentationCode SamplesAnnouncementsMigration HubModelsRelease NotesFAQsBlogVideos
Developer HubAPI StatusSupportSelling Partner API
Developer HubAPI StatusSupport
HomeDocumentationCode SamplesAnnouncementsMigration HubModelsRelease NotesFAQsBlogVideos

Get Started

  • Welcome
  • What is the Selling Partner API?
  • How does the Selling Partner API differ from the Amazon Marketplace Web Service?
  • Terminology
  • SP-API General FAQs
  • SP-API Vendor FAQs

Changelog

  • SP-API Release Notes
  • SP-API Deprecations

Directories

  • SP-API models
  • SP-API Seller Use Cases
  • SP-API Vendor Use Cases
  • Seller Central URLs
  • Vendor Central URLs
  • Reports attributes
  • Feeds attributes

Registration

  • SP-API registration overview
    • Register as a public SP-API developer
    • Register as a private SP-API developer
    • Register as a private SP-API vendor
  • Apply for Restricted (PII) Roles in SP-API
  • Check the status of your request to register as a developer
  • Creating and configuring IAM policies and entities
  • Registering your Application
  • Updating your application information
  • Rotating your application's LWA credentials
  • Viewing your application information and credentials
  • Roles in the Selling Partner API
    • Brand Analytics role
    • Product Listing role
    • Pricing role
    • Amazon Fulfillment role
    • Buyer Communication role
    • Buyer Solicitation role
    • Selling Partner Insights role
    • Finance and Accounting role
    • Inventory and Order Tracking role
    • Direct to Consumer Shipping (Restricted) role
    • Tax Invoicing (Restricted) role
    • Tax Remittance (Restricted) role
  • Policies and Agreements

Authorization and Integration

  • Authorizing Selling Partner API applications
    • Selling Partner Appstore authorization workflow
    • Website authorization workflow
    • Self authorization
    • Authorize vendor groups for application access
    • Authorization with the Restricted Data Token
  • Connecting to the Selling Partner API
  • Building robust Amazon SP-API applications
  • Using SDKs
    • Generating a Java SDK with LWA token exchange and authentication
    • Connecting to the Selling Partner API using a generated Java SDK
    • Generating a Java client library
    • Generate a C# SDK with LWA token generation and authentication
    • Connect to the Selling Partner API using a generated C# SDK
  • Hybrid Selling Partner API applications
  • Authorization Limits
  • Revoke self-authorizations from your application
  • Delete an application from your developer account
  • Authorization Errors

Calling SP-API

  • Selling Partner API sandbox
  • Using Postman for Selling Partner API models
  • Include a User-Agent header in all requests
  • Response format
  • Grantless operations
  • Usage Plans and Rate Limits in the SP-API
  • SP-API Endpoints
  • Marketplace IDs
  • ISO 8601 in SP-API

Selling Partner Appstore

  • What is the Selling Partner Appstore
  • List your app on the Selling Partner Appstore
  • Edit your listing on the Selling Partner Appstore
  • Check the status of your listing
  • Amazon Selling Partner Appstore badge
  • Ratings and reviews in the Selling Partner Appstore

Migrating to SP-API

  • Amazon MWS to SP-API Migration Guide
  • Mapping APIs from Amazon MWS to the Selling Partner API
  • Tutorial: Convert a public Amazon MWS application into a Selling Partner API application
  • Tutorial: Create a private Selling Partner API application
  • Migration FAQ
  • Additional migration resources

Troubleshooting

  • SP-API Errors FAQs
  • URL encoding
  • Resolving 400 errors
  • Authorization Errors

Security and Compliance

  • Amazon Selling Partner API Guard Implementation Guide
    • Cost
    • Architecture overview
    • Components
    • Source code
    • Security
    • Regional deployments
    • Automated Deployment
    • AWS CloudFormation template
    • Update Selling Partner API Guard
    • Uninstall Selling Partner API Guard
    • FAQ
    • Support
    • Document history
    • Selling Partner API Guard Intellectual Property License
  • VAT Calculation Service
    • Prerequisites
    • (Option 1) Allow Amazon to create invoices for you
    • (Option 2) Use the Amazon tax calculation data to create data invoices and then upload the invoices using the SP-API
    • (Option 3) Upload invoices through the SP-API or manually through Seller Central
    • Best Practices
    • Solution provider launch readiness checklist
    • Example use cases
    • Error handling
    • Invoice compliance
    • Invoice correction
    • Remittance information
    • Prices
    • Product Tax Code (PTC)
    • Amazon Prime Wardrobe
    • Partial refunds with VAT-exclusive prices
    • VAT not calculated by Amazon
    • Resources
  • Technical Papers
    • Vulnerability Management
    • Guidance for network protection in SP-API
    • Guidance to address key security controls in SP-API Integration
    • Logging and Monitoring for Amazon API Applications
    • Protecting Amazon API Applications: Data Retention and Recovery
    • Developing Desktop Applications in Amazon SP-API
    • Protecting Amazon API Applications: Data Encryption
    • Protecting Amazon SP-API Applications: Incident Response
    • Safeguarding Sensitive Credentials for SP-API Applications

A+ Content API

  • A+ Content Management API reference
    • aplusContent 2020-11-01.json model
  • A+ Content API Use Case Guide
  • A+ Content Document Examples

Authorization API

  • Authorization API reference
    • Authorization API v1 model
  • Authorization API v1 Use Case Guide
  • Authorization Errors

Catalog Items API

  • Catalog Items API v2022-04-01 reference
    • Catalog Items API v2022-04-01 Use Case Guide
    • Catalog Items API v2022-04-01 model
  • Catalog Items API v2020-12-01 reference
    • Catalog Items API v2020-12-01 Use Case Guide
    • Catalog Items API v2020-12-01 model
  • Catalog Items API v0 reference
    • Catalog Items API v0 model

Easy Ship API

  • Easy Ship API v2022-03-23 reference
    • Easy Ship API v2022-03-23 model
  • Easy Ship API v2022-03-23 Use Case Guide

Fulfillment By Amazon (FBA)

  • FBA Inbound Eligibility API v1 reference
    • FBA Inbound Eligibility API v1 model
  • FBA Inventory API v1 reference
    • FBA Inventory API Use Case Guide
    • FBA Inventory API v1 model
  • FBA Small and Light API v1 reference
    • FBA Small and Light API Use Case Guide
    • FBA Small and Light API v1 model

Feeds API

  • Feeds API v2021-06-30 reference
    • Feeds API v2021-06-30 Use Case Guide
    • Feeds API v2021-06-30 model
  • Feeds API v2020-09-04 reference
    • Feeds API v2020-09-04 Use Case Guide
    • Feeds API v2020-09-04 model
  • Feed Type Values
  • Feeds JSON Schemas
  • Feeds API Best Practices
  • Feeds attributes
    • Business feeds attributes
    • Easy Ship feeds attributes
    • FBA feeds attributes
    • Invoice feeds attributes
    • Listings feeds attributes
    • Order feeds attributes

Finances API

  • Finances API reference
    • Finances v0 model

Fulfillment Inbound API

  • Fulfillment Inbound API v0 reference
    • Fulfillment Inbound API v0 model
  • Fulfillment Inbound API v0 Use Case Guide

Fulfillment Outbound API

  • Fulfillment Outbound API v2020-07-01 reference
    • Fulfillment Outbound API v2020-07-01 model
  • Fulfillment Outbound Dynamic Sandbox Guide
  • Fulfillment Outbound API v2020-07-01 Use Case Guide

Listings

  • Building Listings Management Workflows Guide
  • Migrating Listings Management Workflows
  • Listings Items API v2021-08-01 reference
    • Listings Items API v2021-08-01 Use Case Guide
    • Listings Items API v2021-08-01 model
    • Listings Items API Frequently Asked Questions
    • Listings Items API Issues Troubleshooting
    • Guidance for Complex Attributes
  • Listings Items API v2020-09-01 reference
    • Listings Items API v2020-09-01 Use Case Guide
    • Listings Items API v2020-09-01 model
  • Listings Restrictions API v2021-08-01 reference
    • Listings Restrictions API v2021-08-01 Use Case Guide
    • Listings Restrictions API v2021-08-01 model
  • Product Type Definitions API v2020-09-01 reference
    • Product Type Definitions API v2020-09-01 Use Case Guide
    • Product Type Definitions API v2020-09-01 model
    • Product Type Definitions API FAQs
  • Amazon Product Type Definition Meta-Schema (v1)
    • C# example of meta-schema v1
    • Java example of meta-schema v1
    • Javascript example of meta-schema v1

Merchant Fulfillment API

  • Merchant Fulfillment API v0 reference
    • Merchant Fulfillment API v0 model
  • Merchant Fulfillment API v0 Use Case Guide

Messaging API

  • Messaging API v1 reference
    • Messaging API v1 model
  • Messaging API v1 Use Case Guide

Notifications API

  • Notifications API v1 reference
    • Notifications API v1 model
  • Notifications API v1 Use Case Guide

Orders API

  • Orders API v0 reference
    • Orders API v0 Use Case Guide
    • Orders API v0 model
  • Regulated orders
  • Amazon Business Orders Use Case Guide

Product Fees API

  • Product Fees API v0 reference
    • Product Fees API v0 model
  • Product Fees v0 Use Case Guide

Product Pricing API

  • Product Pricing API v2022-05-01 reference
    • Product Pricing API v2022-05-01 Use Case Guide
    • Product Pricing API v2022-05-01 model
  • Product Pricing API v0 reference
    • Product Pricing API v0 Use Case Guide
    • Product Pricing API v0 model

Replenishment API

  • Replenishment API v2022-11-07 Use Case Guide
  • Replenishment API v2022-11-07 reference
    • Replenishment API v2022-11-07 model

Reports API

  • Reports API v2021-06-30 reference
    • Reports API v2021-06-30 Use Case Guide
    • Tutorial: Request a report
    • Tutorial: Schedule and retrieve reports
    • Tutorial: Retrieve automatically generated reports
    • Verify that the report processing is complete
    • Retrieve a report
    • Reports API v2021-06-30 model
  • Reports API v2020-09-04 reference
    • Reports API v2020-09-04 Use Case Guide
    • Reports API v2020-09-04 model
  • Report Type Values
    • Analytics Reports
    • Inventory Report Type Values
    • Order Report Type Values
    • Returns Report Type Values
    • Performance Report Type Values
    • Settlement Report Type Values
    • Fulfillment by Amazon (FBA) Report Type Values
    • Tax Report Type Values
    • Invoice Data Report Type Values
    • Browse Tree Report Type Values
    • Easy Ship Report Type Values
    • Amazon Business Report Type Values
    • B2B Product Opportunities Report Type Values
    • Regulatory Compliance Report Type Values
  • Reports JSON Schemas
  • Reports API Best Practices
  • Reports attributes
    • Brand Analytics reports attributes
    • Vendor Retail reports attributes
    • Seller Retail reports attributes
    • Inventory reports attributes
    • Order reports attributes
    • Order Tracking reports attributes
    • Pending Order reports attributes
    • Returns reports attributes
    • Performance reports attributes
    • Settlement reports attributes
    • FBA Sales reports attributes
    • FBA Inventory reports attributes
    • FBA Payments reports attributes
    • FBA Customer Concessions reports attributes
    • FBA Removals reports attributes
    • FBA Small and Light reports attributes
    • Tax reports attributes
    • Invoice Data reports attributes
    • Browse Tree reports attributes
    • Easy Ship reports attributes
    • Amazon Business reports attributes
    • B2B Product Opportunities reports attributes
    • Regulatory Compliance reports attributes
  • SP-API for Vendors - Reports FAQ

Sales API

  • Sales API v1 reference
    • Sales API v1 model
  • Sales API v1 Use Case Guide

Sellers API

  • Sellers API v1 reference
    • Sellers API v1 model

Services API

  • Services API v1 reference
    • Services API v1 model

Shipment Invoicing API

  • Shipment Invoicing API v0 reference
    • Shipment Invoicing API v0 model

Shipping API

  • Shipping API v2 resources
  • Shipping API v1 reference
    • Shipping API v1 model

Solicitations API

  • Solicitations API v1 reference
    • Solicitations API v1 model
  • Solicitations API v1 Use Case Guide

Tokens API

  • Tokens API v2021-03-01 reference
    • Tokens API v2021-03-01 model
  • Tokens API Use Case Guide

Uploads API

  • Uploads API reference
    • Uploads API v2020-11-01-model
  • Uploads API Use Case Guide

Vendor Direct Fulfillment APIs

  • Vendor Direct Fulfillment Dynamic Sandbox Guide
  • Vendor Direct Fulfillment Sandbox Test Data API v2021-10-28 reference
    • Vendor Direct Fulfillment Sandbox Test Data API v2021-10-28 model
  • Vendor Direct Fulfillment APIs v1 Use Case Guide
    • Vendor Direct Fulfillment Orders API v1 Use Case Guide
    • Vendor Direct Fulfillment Shipping API v1 Use Case Guide
    • Vendor Direct Fulfillment Payments API v1 Use Case Guide
    • Vendor Direct Fulfillment Inventory API v1 Use Case Guide
    • Vendor Direct Fulfillment Transaction Status API v1 Use Case Guide
  • Vendor Direct Fulfillment Inventory API v1 reference
    • Vendor Direct Fulfillment Inventory API v1 model
  • Vendor Direct Fulfillment Transactions API v1 reference
    • Vendor Direct Fulfillment Transactions API v1 model
  • Vendor Direct Fulfillment Orders API v1 reference
    • Vendor Direct Fulfillment Orders API v1 model
  • Vendor Direct Fulfillment Shipping API v1 reference
    • Vendor Direct Fulfillment Shipping API v1 model
  • Vendor Direct Fulfillment Payments API v1 reference
    • Vendor Direct Fulfillment Payments API v1 model
  • Vendor Direct Fulfillment Orders API v2021-12-28 reference
    • Vendor Direct Fulfillment Orders API v2021-23-28 Use Case Guide
    • Vendor Direct Fulfillment Orders API v2021-12-28 model
  • Vendor Direct Fulfillment Shipping API v2021-12-28 reference
    • Vendor Direct Fulfillment Shipping API v2021-12-28 Use Case Guide
    • Vendor Direct Fulfillment Shipping API v2021-12-28 model
  • Vendor Direct Fulfillment Transactions API v2021-12-28 reference
    • Vendor Direct Fulfillment Transaction Status API v2021-12-28 Use Case Guide
    • Vendor Direct Fulfillment Transactions API v2021-12-28 model
  • SP-API bill to party addresses
  • Vendor Direct Fulfillment FAQ

Vendor Retail Procurement APIs

  • Vendor Retail Procurement APIs v1 Use Case Guide
  • SP-API bill to party addresses
  • Vendor Invoices API v1 reference
    • Vendor Invoices API v1 model
  • Vendor Shipments API v1 reference
    • Vendor Shipments API v1 model
  • Vendor Transaction Status API v1 reference
    • Vendor Transaction Status API v1 model
  • Vendor Orders API v1 reference
    • Vendor Orders API v1 model
  • Vendor Retail Procurement FAQ

Additional migration resources

SP-API migration resources.

  • Migration Hub
  • SP-API Migration FAQs
  • What is the Selling Partner API?
  • Selling Partner API (SP-API) Video Series on YouTube
  • Contact Amazon Selling Partner Developer Support in Seller Central

Updated about 1 month ago


Acceptable Use Policy  |   Data Protection Policy  |   Amazon Services API Developer Policy Privacy notice  |   Conditions of use