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

ListInboundShipmentsByNextToken

Returns the next page of inbound shipments using the NextToken parameter.

Description

The ListInboundShipmentsByNextToken operation returns the next page of inbound shipments using the NextToken value that was returned by your previous request to either ListInboundShipments or ListInboundShipmentsByNextToken. If NextToken is not returned, there are no more pages to return.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

The ListInboundShipments and ListInboundShipmentsByNextToken operations together share 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

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Values
NextToken A string token returned in the response of your previous request to either ListInboundShipments or ListInboundShipmentsByNextToken. Yes Type: xs:string

Response elements

Name Description
NextToken A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to ListInboundShipmentsByNextToken. If NextToken is not returned, there are no more inbound shipments to return.

Optional

Type: xs:string
ShipmentData Information about your inbound shipments. The ShipmentData response element does not include item information.

Type: InboundShipmentInfo

Examples

Example query request

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

Show example code Hide example code

http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/
  ?Action=ListInboundShipmentsByNextToken
  &Version=2010-10-01
  &AWSAccessKeyId=1QZHP8EXAMPLE1N5R44N
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Signature=VY6sqvdk01VEG0VEXAMPLEh4oj3
  &Timestamp=2015-12-02T02:40:36Z
  &SellerId=1234567890
  &NextToken=QVYyVTY5NUVaQzBDWHw0ODh8MjAwfCB8IHw1OTM0MDZ8IHwwLDJ8
  IHwgfCB8IHx0cnVl

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<ListInboundShipmentsByNextTokenResponse xmlns="http://mws.amazonaws.com/FulfillmentInboundShipment/2010-10-01/">
    <ListInboundShipmentsByNextTokenResult>
        <NextToken>QVYyVTY5NUVaQzBDWHw0ODh8MjAwfCB8IHw1OTM0MDZ8IHwwLDJ8
            IHwgfCB8IHx0cnVl</NextToken>
        <ShipmentData>
            <member>
                <ShipFromAddress>
                    <PostalCode>98101</PostalCode>
                    <Name>Joan Doe</Name>
                    <CountryCode>US</CountryCode>
                    <StateOrProvinceCode>WA</StateOrProvinceCode>
                    <AddressLine2>Apt 2</AddressLine2>
                    <AddressLine1>876 Elm St</AddressLine1>
                    <City>Seattle</City>
                </ShipFromAddress>
                <AreCasesRequired>false</AreCasesRequired>
                <ShipmentId>SSF85DGIZZ7PKF</ShipmentId>
                <ShipmentStatus>WORKING</ShipmentStatus>
                <ShipmentName>ExampleShipmentName4</ShipmentName>
                <DestinationFulfillmentCenterId>RNO2
                </DestinationFulfillmentCenterId>
                <LabelPrepType>SELLER_LABEL</LabelPrepType>
            </member>
            <member>
                <ShipFromAddress>
                    <PostalCode>98101</PostalCode>
                    <Name>Joan Doe</Name>
                    <CountryCode>US</CountryCode>
                    <StateOrProvinceCode>WA</StateOrProvinceCode>
                    <AddressLine2>Apt 2</AddressLine2>
                    <AddressLine1>876 Elm St</AddressLine1>
                    <City>Seattle</City>
                </ShipFromAddress>
                <AreCasesRequired>true</AreCasesRequired>
                <ShipmentId>SSF85DGIZZ7PL3</ShipmentId>
                <ShipmentStatus>SHIPPED</ShipmentStatus>
                <ShipmentName>ExampleShipmentName5</ShipmentName>
                <DestinationFulfillmentCenterId>RNO2
                </DestinationFulfillmentCenterId>
                <LabelPrepType>SELLER_LABEL</LabelPrepType>
                <ConfirmedNeedByDate>2015-12-30</ConfirmedNeedByDate>
            </member>
        </ShipmentData>
    </ListInboundShipmentsByNextTokenResult>
    <ResponseMetadata>
        <RequestId>8547a35c-8e70-11df-8af1-5bf2881764d8</RequestId>
    </ResponseMetadata>
</ListInboundShipmentsByNextTokenResponse>

↑ Top