For AI agents: the docs index is at https://developer-docs.amazon/sp-api/llms.txt. The index for every project on this site is at https://developer-docs.amazon/llms.txt. Append .md to any documentation page URL to get its markdown version.

Jump to Content

Home Documentation API Reference Announcements Models Release Notes FAQ GitHub Videos

Developer Hub API Status Support

Documentation

Developer Hub API Status Support

Home Documentation API Reference Announcements Models Release Notes FAQ GitHub Videos

Get Started

Welcome to SP-API Documentation
What is the Selling Partner API?
Selling Partner API Onboarding Overview
- Onboarding as a Developer
- Onboarding as a Service Provider
Terminology
Frequently Asked Questions

Changelog

SP-API Release Notes
SP-API Deprecation Schedule
SP-API Product Metadata Updates

Directories

SP-API Models
SP-API Seller Use Cases
SP-API Vendor Use Cases
Seller Central URLs
Vendor Central URLs

Registration

SP-API Registration Overview
Developer Registration Request Status
Third-Party Provider Registration
- Third-Party Provider Signature Guidance
Service Provider Registration and Role Approval Process Overview
Understanding Seller Central Role Eligibility for Service Providers
Website Guidelines for Public Developers and Service Providers
User Permissions for Service Providers
Register your Application
Update your Application Information
Rotate your Application's LWA Credentials
- LWA Credentials FAQ
View your Application Information and Credentials
Learn How Sellers Authorize Service Providers
Selling Partner API Roles
- Role Mappings for SP-API Operations
- Role Mappings for SP-API Types
Policies and Agreements
About Facial Data

Authorization

Authorize Applications
- Authorize Public Applications
  - Selling Partner Appstore Authorization Workflow
  - Website Authorization Workflow
- Authorize Private Applications
Reauthorize Applications
Reactivate Authorizations
Revoke Authorizations
Authorization Limits
Special Authorization Types
- Authorize your Application to Access Vendor Groups
- Authorization with the Restricted Data Token

Integration

Building Robust Amazon SP-API Applications
SP-API SDKs
Delete an Application From Your Developer Account

Calling the SP-API

Configuration Details
Call Structure
- Connect to the SP-API
- Parse SP-API Responses
Development Tools
- Selling Partner API Sandbox
- Using Postman for Selling Partner API Models
Performance Management
Store Identifiers

Solution Provider Portal

Manage Users in Solution Provider Portal
Manage Your Business And Contact information in Solution Provider Portal
Update Your Developer Profile in Solution Provider Portal
Unify Your Developer Accounts
Verify Your Identity in Solution Provider Portal
API Usage Metrics in Solution Provider Portal

Shop Direct

What is Shop Direct?
Create a Shop Direct Listing Without Variations
Create a Shop Direct Listing With Variations
Delete a Shop Direct Listing
Get Authorization to Manage a Shop Direct merchant's Shop Direct Listings
Troubleshoot Shop Direct Listing Errors
Update a Shop Direct Listing

Tutorials

Tutorial: Test Selling Partner API Endpoints
Tutorial: Automate your SP-API Calls Using a C# SDK
Tutorial: Automate your SP-API Calls Using a Java SDK
Tutorial: Automate your SP-API Calls Using a JavaScript SDK for Node.js
Tutorial: Automate your SP-API Calls Using a Python SDK
Tutorial: Automate your SP-API Calls using a prebuilt C# SDK
Tutorial: Automate your SP-API Calls using prebuilt Java SDK
Tutorial: Automate your SP-API Calls using a prebuilt JavaScript SDK
Tutorial: Automate your SP-API Calls using prebuilt PHP SDK
Tutorial: Automate your SP-API calls using a prebuilt Python SDK
Tutorial: Authorize Multiple Vendor Central Accounts with a Single SP-API Application
Tutorial: Retrieve Merchant Shipping Templates
Tutorial: Grant the SP-API Permission to an Amazon SQS Queue
Tutorial: Retrieve and Pass a Purchase Order Number to a Carrier

Troubleshooting

Troubleshoot SP-API Errors
URL Encoding
Resolve Common HTTP and Authorization Error Codes
External Fulfillment Errors
Listings Items API Issues Troubleshooting

Selling Partner Appstore

What is the Selling Partner Appstore?
List Your App on the Selling Partner Appstore
Edit Your Appstore Listing
Check Listing Status
Appstore Ratings and Reviews
Press Releases and Promotions

Service Provider Network

List Your Service

Security and Compliance

SP-API Security and Compliance Overview
Amazon Selling Partner API Guard Implementation Guide
VAT Calculation Service
Amazon Seller Data Access
Best Practices

A+ Content API

A+ Content API
A+ Content Examples
A+ Content API Rate Limits
A+ Premium Modules
A+ Brand Story Modules
A+ Content Troubleshooting Guide

Action Items API

Action Items API
- Dismiss an Action Item
- Create an Action Plan to Address an Action Item

Action Plans API

Action Plans API
- Create an Action Plan to Address an Action Item

Amazon Warehousing and Distribution API

Amazon Warehousing and Distribution API
Amazon Warehousing and Distribution API v2024-05-09 Reference

App Integrations API

App Integrations API

Application Management API

Application Management API
- Set up credential rotation notifications
- Rotate your application's client secret

Catalog Items API

Catalog Items API
- Retrieve catalog item details
- Search catalog items
Catalog Items API Rate Limits
Catalog Items API v2022-04-01 Reference

Customer Feedback API

Customer Feedback API
- Get Feedback Insights for an ASIN
- Get Feedback Insights for a Browse Node
Customer Feedback API Rate Limits

Data Kiosk

Data Kiosk API
- Request and filter data with a GraphQL query
- Verify that query processing is complete
Data Kiosk Schema Explorer User Guide
Data Kiosk Query Processing Finished Notification
Building Data Kiosk workflows guide
Vendor Analytics Dataset Use Case Guide
Schedule Data Kiosk Queries
Seller Analytics Dataset Use Case Guide

Delivery by Amazon API

Delivery by Amazon API
- Submit an invoice for Delivery by Amazon and Self Ship orders
- Check the invoice submission status for Delivery by Amazon and Self Ship orders

Easy Ship API

Easy Ship API

External Fulfillment

External Fulfillment Inventory API
- Publish Location-Level Inventory
- Retrieve Location-Level Inventory
External Fulfillment Returns API
- Retrieve Return Information
External Fulfillment Shipping API
External Fulfillment Errors
External Fulfillment APIs Rate Limits

Fulfillment By Amazon (FBA)

FBA Inventory API
- Get inventory summaries
FBA Inventory Dynamic Sandbox Guide

Feeds API

Feeds API
- Submit a feed
Feed Type Values
Feeds JSON Schemas
Feeds API Best Practices
Feeds API FAQ
Feeds API Rate Limits

Finances

Finances API
Transfers API
Invoices API
- Retrieve invoice headers
- Get invoice details

Finance Remittance API

Finance Remittance API

Fulfillment Inbound API

Fulfillment Inbound API
Fulfillment Inbound API FAQ
Migrating Fulfillment Inbound workflows
Fulfillment Inbound API Rate Limits

Fulfillment Outbound API

Fulfillment Outbound API
Fulfillment Outbound Workflow Guide
Fulfillment Outbound Dynamic Sandbox Guide
Fulfillment Outbound API Migration Guide
Fulfillment Outbound Troubleshooting Guide
MCF Best Practices
Fulfillment Outbound API Rate Limits

Invoicing

Invoices API (Brazil Only)
- Export invoice files
Invoices API FAQ

Listings

Listings Items API
Listings Items API Rate Limits
Listings Restrictions API
- Get listings restrictions for an item in the catalog
Listings Restrictions API Rate Limits
Manage Product Listings with the Selling Partner API
Building Listings Management Workflows Guide
Understanding Amazon listing status and seller-fulfilled inventory management
Submit Listings data
Manage Amazon Haul, Advanced Multiple-Offer, and Multiple-Fulfillment Use Cases
Listings APIs FAQ
Product Type Definitions API
Product Type Definitions API Rate Limits
Update prices for multiple marketplaces

Merchant Fulfillment API

Merchant Fulfillment API

Messaging

Messaging API
- Send a message
Messaging Automations API
- Update or deactivate an automation configuration

Notifications API

Notifications API
Notification Type Values
Subscribe to the ORDER_CHANGE Notification
Subscribe to shipment tracking notifications

Orders API

Orders API
Tutorial: Retrieve and Pass a Purchase Order Number to a Carrier
Orders API Migration Guide
Orders API Rate Limits

Product Fees API

Product Fees API

Product Pricing API

Product Pricing API
- Return a batch of FOEP data for a set of SKUs
- Retrieve a list of featured offers for a batch of up to 20 ASINs
Product Pricing API and Notifications FAQ
Price Adjustment Automation Workflows Guide
Manage automated pricing rules with SP-API

Promotions API

Promotions API

Replenishment API

Replenishment API

Reports API

Reports API
Report Type Values
Reports JSON Schemas
Reports API FAQ

Sales API

Sales API
- Receive sales performance information

Seller Wallet API

Seller Wallet API
Seller Wallet API Rate Limits

Sellers API

Sellers API
- Get the account information of a seller
- Get the market participation of a seller

Services API

Services API

Shipment Invoicing API

Shipment Invoicing API
- Retrieve shipment information
- Submit a shipment invoice

Shipping API

Shipping API v2 Resources
Shipping API v1 Reference

Solicitations API

Solicitations API
- Set up the Solicitations API
- Solicit feedback for an order

Supply Sources API

Supply Sources API
Multi-Location Inventory Integration Guide
Supply Sources API Rate Limits

Support API

Support API
- Retrieve and Review Selling Partner Support Cases
- Retrieve the Contact History for a Support Case

Tokens API

Tokens API

Tracking API

Tracking API
- Track an external channel shipment
- Shipment milestone event subcodes

Uploads API

Uploads API
- Create an upload destination

Vehicles API

Vehicles API
- Provide fitment information on ASINs
Vehicles API Rate Limits

Vendor Direct Fulfillment APIs

Vendor Direct Fulfillment Dynamic Sandbox Guide
Vendor Direct Fulfillment Workflow Guide

Vendor Direct Fulfillment Transaction Status API

Vendor Direct Fulfillment Transaction Status API
- Get the transaction status

Vendor Direct Fulfillment Inventory API

Vendor Direct Fulfillment Inventory API
- Submit an inventory update

Vendor Direct Fulfillment Orders API

Vendor Direct Fulfillment Orders API

Vendor Direct Fulfillment Shipping API

Vendor Direct Fulfillment Shipping API

Vendor Direct Fulfillment Payments API

Vendor Direct Fulfillment Payments API
- Submit an invoice
SP-API Bill-to-Party Addresses

Vendor Retail Procurement Invoices API

Vendor Retail Procurement Invoices API
- Submit credit notes
- Submit invoices

Vendor Retail Procurement Orders API

Vendor Retail Procurement Orders API
SP-API Bill-to-Party Addresses

Vendor Retail Procurement Shipments API

Vendor Retail Procurement Shipments API

Vendor Retail Procurement Transaction Status API

Vendor Retail Procurement Transaction Status API
- Get transaction status

Uploads v2020-11-01

Uploads v2020-11-01

Finances v0

Finances v0

Product Pricing v2022-05-01

Product Pricing v2022-05-01

Vendor Direct Fulfillment Transactions v1

Vendor Direct Fulfillment Transactions v1

Product Pricing v0

Product Pricing v0

Supply Sources v2020-07-01

Supply Sources v2020-07-01

Notifications v1

Notifications v1

Orders v0

Orders v0

Transfers v2024-06-01

Transfers v2024-06-01

External Fulfillment Shipping v2024-09-11

External Fulfillment Shipping v2024-09-11

Action Items v2026-06-01

Action Items v2026-06-01

A+ Content Management v2020-11-01

A+ Content Management v2020-11-01

Tokens v2021-03-01

Tokens v2021-03-01

Customer Feedback v2024-06-01

Customer Feedback v2024-06-01

Messaging Automations v2026-04-20

Messaging Automations v2026-04-20

Vendor Direct Fulfillment Shipping v1

Vendor Direct Fulfillment Shipping v1

Action Plans v2026-06-01

Action Plans v2026-06-01

App Integrations v2024-04-01

App Integrations v2024-04-01

Application Management v2023-11-30

Application Management v2023-11-30

Messaging v1

Messaging v1

Feeds v2021-06-30

Feeds v2021-06-30

Vendor Direct Fulfillment Transactions v2021-12-28

Vendor Direct Fulfillment Transactions v2021-12-28

Listings Restrictions v2021-08-01

Listings Restrictions v2021-08-01

Solicitations v1

Solicitations v1

Invoices v2024-06-19 (Brazil Only)

Invoices v2024-06-19 (Brazil Only)

Vendor Direct Fulfillment Payments v1

Vendor Direct Fulfillment Payments v1

Orders v2026-01-01

Orders v2026-01-01

External Fulfillment Returns v2024-09-11

External Fulfillment Returns v2024-09-11

Shipment Invoicing v0

Shipment Invoicing v0

FBA Inventory v1

FBA Inventory v1

Fulfillment Outbound v2026-07-04

Fulfillment Outbound v2026-07-04

Vendor Direct Fulfillment Orders v2021-12-28

Vendor Direct Fulfillment Orders v2021-12-28

Data Kiosk v2023-11-15

Data Kiosk v2023-11-15

Finances v2024-06-19

Finances v2024-06-19

Reports v2021-06-30

Reports v2021-06-30

Vendor Direct Fulfillment Shipping v2021-12-28

Vendor Direct Fulfillment Shipping v2021-12-28

Merchant Fulfillment v0

Merchant Fulfillment v0

Seller Wallet v2024-03-01

Seller Wallet v2024-03-01

Vendor Direct Fulfillment Sandbox Test Data v2021-10-28

Vendor Direct Fulfillment Sandbox Test Data v2021-10-28

Vendor Invoices v1

Vendor Invoices v1

Catalog Items v0

Catalog Items v0

Listings Items v2021-08-01

Listings Items v2021-08-01

Vendor Direct Fulfillment Orders v1

Vendor Direct Fulfillment Orders v1

Services v1

Services v1

Delivery By Amazon v2022-07-01

Delivery By Amazon v2022-07-01

Product Type Definitions v2020-09-01

Product Type Definitions v2020-09-01

Fulfillment Inbound v2024-03-20

Fulfillment Inbound v2024-03-20

Fulfillment Outbound v2020-07-01

Fulfillment Outbound v2020-07-01

Promotions v2025-12-01

Promotions v2025-12-01

Tracking v2026-01-30

Tracking v2026-01-30

Vendor Shipments v1

Vendor Shipments v1

Finance Remittance v2026-03-17

Finance Remittance v2026-03-17

Vendor Transaction Status v1

Vendor Transaction Status v1

Catalog Items v2022-04-01

Catalog Items v2022-04-01

Vendor Direct Fulfillment Inventory v1

Vendor Direct Fulfillment Inventory v1

Sellers v1

Sellers v1

Catalog Items v2020-12-01

Catalog Items v2020-12-01

Product Fees v0

Product Fees v0

Support v2025-02-01

Support v2025-02-01

Amazon Warehousing and Distribution v2024-05-09

Amazon Warehousing and Distribution v2024-05-09

FBA Inbound Eligibility v1

FBA Inbound Eligibility v1

Easy Ship v2022-03-23

Easy Ship v2022-03-23

Fulfillment Inbound v0

Fulfillment Inbound v0

Sales v1

Sales v1

Vehicles v2024-11-01

Vehicles v2024-11-01

External Fulfillment Inventory v2024-09-11

External Fulfillment Inventory v2024-09-11

Vendor Orders v1

Vendor Orders v1

Invoices v2026-06-25

Invoices v2026-06-25

Replenishment v2022-11-07

Replenishment v2022-11-07

Listings Items v2020-09-01

Listings Items v2020-09-01

External Fulfillment Location v2026-07-30

External Fulfillment Location v2026-07-30

Powered by

External Fulfillment Returns v2024-09-11

Use the External Fulfillment Returns API to retrieve return information for Amazon External Fulfillment.

For more information, refer to:

External Fulfillment Returns API
External Fulfillment Returns model

Updated about 1 hour ago

Orders v2026-01-01

Shipment Invoicing v0

Policies and Agreements Privacy notice | Conditions of use