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

Developer Guide

  • What is the Selling Partner API
    • About this guide
    • Terminology
    • How does the Selling Partner API differ from the Amazon Marketplace Web Service
  • SP-API Endpoints
  • Marketplace IDs
  • Determine app type
  • Registering as a developer
    • Checking 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
  • 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
  • Authorizing Selling Partner API applications
    • Selling Partner Appstore authorization workflow
    • Website authorization workflow
    • Self authorization
    • Authorization with the Restricted Data Token
    • 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
    • Connecting to the Selling Partner API
    • Response format
    • Grantless operations
    • Include a User-Agent header in all requests
    • Hybrid Selling Partner API applications
    • Authorization Limits
    • Revoke self-authorizations from your application
    • Authorization Errors
  • Delete an application from your developer account
  • Selling Partner API sandbox
  • About Vendor Groups
  • ISO 8601 in SP-API
  • Seller Central URLs
  • Vendor Central URLs
  • Policies and Agreements
  • SP-API General FAQs
  • SP-API Vendor FAQs
  • SP-API Errors FAQs

Directories

  • SP-API models
  • SP-API Seller Use Cases
  • SP-API Vendor Use Cases
  • Feeds attributes

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

User Guides

  • 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
  • Usage Plans and Rate Limits in the SP-API
  • Using Postman for Selling Partner API models
  • URL encoding
  • 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

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
  • Technical Papers
    • 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

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 API v2020-07-01 Use Case Guide

Listings

  • Building Listings Management Workflows Guide
  • 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

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
  • Regulated orders
  • Orders API v0 model
  • 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

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
  • Reports API Best Practices
  • Vendor Retail Analytics Reports Migration Guide
  • 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 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 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-23-28 Use Case Guide
    • Vendor Direct Fulfillment Transactions API v2021-12-28 model
  • Vendor Direct Fulfillment FAQ

Vendor Retail Procurement APIs

  • Vendor Retail Procurement APIs v1 Use Case Guide
  • 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

Technical Papers

  • Guidance to address key security controls in SP-API Integration
  • Developing Desktop Applications in Amazon SP-API
  • Logging and Monitoring for Amazon API Applications
  • Protecting Amazon API Applications: Data Encryption
  • Protecting Amazon API Applications: Data Retention and Recovery
  • Protecting Amazon SP-API Applications: Incident Response
  • Safeguarding Sensitive Credentials for SP-API Applications

Updated about 2 months ago


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