Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Returns information about the availability of a seller's inventory.
The ListInventorySupply operation returns information about the availability of inventory that a seller has in Amazon's fulfillment network and in current inbound shipments. You can check the current availabilty status for your Fulfillment by Amazon inventory as well as discover when availability status changes.
This operation is available in all marketplaces except Brazil.
The ListInventorySupply operation has a maximum request quota of 30 and a restore rate of two requests every second. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.
Name | Description | Required | Values |
---|---|---|---|
SellerSkus | A list of seller SKUs for items that you want inventory availability information about. | Yes, if QueryStartDateTime is not
specified. Specifying both QueryStartDateTime and SellerSkus returns an error. |
Seller SKUs for items that you have shipped to an Amazon fulfillment center. Maximum: 50 Type: xs:string |
QueryStartDateTime | A date used for selecting items that have had changes in inventory availability after (or at) a specified time. | In ISO 8601 date time format
Type: xs:dateTime |
|
ResponseGroup | Indicates whether or not you want the ListInventorySupply operation to return the SupplyDetail element. | No | ResponseGroup values:
Default: Basic Type: xs:string |
MarketplaceId
(NA only) |
An encrypted Amazon defined marketplace identifier. It is used to limit the scope of a request or response to a specific marketplace. | No Assumes the default value if MarketplaceId is not specified. |
MarketplaceId values: For a list of MarketplaceId values, see Amazon MWS endpoints MarketplaceId values in the Amazon MWS Developer Guide. Default: The MarketplaceId assigned as the seller's home marketplace. Type: xs:string |
Name | Description | Required | Values |
---|---|---|---|
NextToken | A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to ListInventorySupplyByNextToken. If NextToken is not returned, there is no more inventory availability information to return. | Optional | Type: xs:string |
InventorySupplyList | A list of items that are or soon will be available for fulfillment by Amazon's fulfillment network. Each item is either currently in the fulfillment network or is in an inbound shipment to an Amazon fulfillment center. SKU, ASIN, condition, quantity, and availability information is included with each item. | Yes | Type: List of InventorySupply |
For information about standard request requirements, see Required request parameters.
https://mws.amazonservices.com/FulfillmentInventory/2010-10-01 ?Action=ListInventorySupply &Version=2011-03-01 &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D &Timestamp=2010-10-01T02:40:36Z &SellerId=A2NKEXAMPLEF53 &SellerSkus.member.1=SampleSKU1 &SellerSkus.member.2=SampleSKU2 &ResponseGroup=Basic
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ListInventorySupplyResponse xmlns="http://mws.amazonaws.com/FulfillmentInventory/2010-10-01"> <ListInventorySupplyResult> <InventorySupplyList> <member> <SellerSKU>SampleSKU1</SellerSKU> <ASIN>B00000K3CQ</ASIN> <TotalSupplyQuantity>20</TotalSupplyQuantity> <FNSKU>X0000000FM</FNSKU> <Condition>NewItem</Condition> <SupplyDetail/> <InStockSupplyQuantity>15</InStockSupplyQuantity> <EarliestAvailability> <TimepointType>Immediately</TimepointType> </EarliestAvailability> </member> <member> <SellerSKU>SampleSKU2</SellerSKU> <ASIN>B00004RWQR</ASIN> <TotalSupplyQuantity>0</TotalSupplyQuantity> <FNSKU>X00008FZR1</FNSKU> <Condition>UsedLikeNew</Condition> <SupplyDetail/> <InStockSupplyQuantity>0</InStockSupplyQuantity> </member> </InventorySupplyList> </ListInventorySupplyResult> <ResponseMetadata> <RequestId>e8698ffa-8e59-11df-9acb-230ae7a8b736</RequestId> </ResponseMetadata> </ListInventorySupplyResponse>
For information about standard request requirements, see Required request parameters.
http://mws.amazonaws.com/FulfillmentInventory/2010-10-01/ ?Action=ListInventorySupply &Version=2010-10-01 &AWSAccessKeyId=1QZHP81N5R44N89PFAKE &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Signature=VY6sqvdk01VEG0V+h4oj3FBFAKE= &Timestamp=2010-10-01T02:40:36Z &SellerId=1234567890 &QueryStartDateTime=2011-05-03T06%3A00%3A00Z &ResponseGroup=Detailed
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ListInventorySupplyResponse xmlns="http://mws.amazonaws.com/FulfillmentInventory/2010-10-01/"> <ListInventorySupplyResult> <NextToken>H4sIAAAAAAAAADXQzW6CMAAA4FcxXD3AgE5J5pLSiBTQ8Sc SblCB0Ap2LSL49O6y7xGr05WbPW8ip3SlDdZK6t3CmuKTH8d9B/0mhCR7gcV E3gpuDaR8850n239tjC17Z3Gg2PmsZJNa14izwUtQAMYp6tOH4NHl/gN492S YVU0P5F0OYwUwmYI0d/YHnMSgDPUF0mvxTPNofZkXr6ww39SIBYJUTlUMNwI WaduUNr/MZYmaySPqugvxiQaTs2Rxgs1gFENKcUV7Ry/8BSUECjcj2sQ7bLT nBvYPd9/ksLbmV5ydt+HUWFx1QMQgD7O5Ey96mZzNZypKo7V9nBUtPNp/Azt F/X4Di21K/SkBAAA=</NextToken> <InventorySupplyList> <member> <SellerSKU>SampleSKU3</SellerSKU> <ASIN>BT008FQ92Q</ASIN> <TotalSupplyQuantity>18</TotalSupplyQuantity> <FNSKU>X0000000EY</FNSKU> <Condition>NewItem</Condition> <SupplyDetail> <member> <EarliestAvailableToPick> <TimepointType>Immediately</TimepointType> </EarliestAvailableToPick> <Quantity>5</Quantity> <LatestAvailableToPick> <TimepointType>Immediately</TimepointType> </LatestAvailableToPick> <SupplyType>InStock</SupplyType> </member> <member> <EarliestAvailableToPick> <TimepointType>DateTime</TimepointType> <DateTime>2011-05-04T23:00:00Z</DateTime> </EarliestAvailableToPick> <Quantity>13</Quantity> <LatestAvailableToPick> <TimepointType>DateTime</TimepointType> <DateTime>2011-05-04T23:00:00Z</DateTime> </LatestAvailableToPick> <SupplyType>InStock</SupplyType> </member> </SupplyDetail> <InStockSupplyQuantity>4</InStockSupplyQuantity> </member> </InventorySupplyList> </ListInventorySupplyResult> <ResponseMetadata> <RequestId>e26d8d21-8e5c-11df-9acb-230ae7a8b736</RequestId> </ResponseMetadata> </ListInventorySupplyResponse>