Jump to Content
Selling Partner API
HomeDocumentationAnnouncementsMigration HubRelease NotesModelsFAQsBlog
Developer ConsoleAPI StatusSupportSelling Partner API
Developer ConsoleAPI StatusSupport
HomeDocumentationAnnouncementsMigration HubRelease NotesModelsFAQsBlog

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
    • Authorization Errors
  • 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

Use Case Directories

  • SP-API Seller Use Cases
  • SP-API Vendor Use Cases

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
    • Selling Partner API Guard Video
    • 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 Use Case Guide
  • Authorization API v1 model

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 Use Case Guide
  • Easy Ship API v2022-03-23 model

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
    • Listings Feed Schema v2
    • Listings Feed Schema V2 example
    • Listings Feed Message Schema V2
    • Listings Feed Processing Report Schema V2
    • Listings Feed Processing Report Schema V2 example
  • Feeds API Best Practices

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 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 Use Case Guide
  • Notifications API v1 model

Orders API

  • Orders API v0 reference
  • Regulated orders
  • Orders API v0 model

Product Fees API

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

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

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 Use Case Guide
  • Tokens API v2021-03-01 model

Uploads API

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

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

Resources

VAT Calculation Service Guide resources

For information about the methodology Amazon uses to calculate VAT, refer to European VAT Calculation Services Methodology, and VAT Calculation Service - FAQs in the Seller Central Help.

For the EU and UK PTCs and VAT rates, refer to VAT Rates and My PTCs in the Seller Central Help.

Updated 5 months ago


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