The Amazon Selling Partner API (SP-API) is the successor to MWS and provides REST-based access to Amazon marketplace data. Manage product listings and inventory, process and ship orders, retrieve financial reports and settlements, automate pricing, access advertising campaign data, and integrate with Fulfillment by Amazon (FBA). Used by large-scale sellers, third-party sellers, repricing tools, and ERP integrations. Requires Amazon seller account and approved SP-API application.
https://sellingpartnerapi-na.amazon.com
Auth type
OAuth 2.0
Auth header
Authorization: Bearer ACCESS_TOKEN
x-amz-access-token: ACCESS_TOKEN
Rate limit
Varies by endpoint (e.g., Orders: 0.0167 req/sec, Listings: 5 req/sec)
Pricing
Free tier available
Free quota
Sandbox environment is free for development
Documentation
https://developer-docs.amazon.com/sp-api
Endpoint status
Server online — HTTP 500 — server is online but path returned an error (may require auth)1.02s
(checked Mar 29, 2026)
Builder score
C
61%
builder-friendly
SP-API uses LWA (Login with Amazon) OAuth 2.0. Exchange your client credentials for an access token, then sign each request with AWS SigV4 using your IAM role credentials.
Authorization: Bearer ACCESS_TOKEN x-amz-access-token: ACCESS_TOKEN
Most SP-API endpoints are free for approved sellers. Some advanced analytics APIs have usage-based fees. Amazon charges sellers separately for marketplace fees (referral fees, FBA fees, etc.).
| Method | Path | Description |
|---|---|---|
| GET | /orders/v0/orders |
List orders filtered by status, date, and marketplace |
| GET | /listings/2021-08-01/items/{sellerId}/{sku} |
Get a listing by seller SKU |
| GET | /fba/inventory/v1/summaries |
Get FBA inventory levels and conditions |
| GET | /finances/v0/financialEvents |
List financial events (settlements, charges) |
| GET | /catalog/2022-04-01/items/{asin} |
Get product details and search keywords for an ASIN |
| PUT | /pricing/v0/price |
Update listing prices for competitive repricing |
# SP-API requires AWS SigV4 signing — shown with simplified headers curl "https://sellingpartnerapi-na.amazon.com/orders/v0/orders?MarketplaceIds=ATVPDKIKX0DER&OrderStatuses=Unshipped" \ -H "x-amz-access-token: $SP_API_ACCESS_TOKEN" \ -H "x-amz-date: 20240315T100000Z"
{
"payload": {
"Orders": [{
"AmazonOrderId": "114-1234567-1234567",
"OrderStatus": "Unshipped",
"PurchaseDate": "2024-03-15T08:00:00Z",
"OrderTotal": { "Amount": "49.99", "CurrencyCode": "USD" },
"NumberOfItemsShipped": 0,
"NumberOfItemsUnshipped": 2
}]
}
}
Data sourced from API Map. Always verify pricing and rate limits against the official Amazon documentation.