Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

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.

Amazon MWS Documentation

ListInventorySupply

Returns information about the availability of a seller's inventory.

Description

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 does not return availability information for inventory that is:
  • Unsellable
  • Bound to a customer order

Availability

This operation is available in all marketplaces except Brazil.

Throttling

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.

Request parameters

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:
  • Basic - Does not include the SupplyDetail element in the response
  • Detailed - Includes the SupplyDetail element in the response

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

Response elements

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

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

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

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

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

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top