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

GetOrder

Returns orders based on the AmazonOrderId values that you specify.

Description

The GetOrder operation returns an order for each AmazonOrderId that you specify, up to a maximum of 50. The GetOrder operation includes order information for each order returned, including PurchaseDate, OrderStatus, FulfillmentChannel, and LastUpdateDate.

Availability of buyer contact and charge information

The following tables show when the GetOrder operation returns buyer contact information (BuyerEmail, BuyerName, ShippingAddress) and charge information (OrderTotal).

Table 1. Standard orders
For a standard order with this order status: …the GetOrder operation returns these buyer contact and charge information response elements:
Pending None
Unshipped, PartiallyShipped, Shipped BuyerEmail1, BuyerName, ShippingAddress, OrderTotal
Table 2. Pre-orders
For a pre-order with this order status: …the GetOrder operation returns these buyer contact and charge information response elements:
PendingAvailability2, Pending BuyerEmail1, BuyerName
Unshipped, PartiallyShipped, Shipped BuyerEmail1, BuyerName, ShippingAddress, OrderTotal
  1. BuyerEmail is not returned for Fulfillment by Amazon gift orders.
  2. The PendingAvailability status is available only for pre-orders in Japan.

Availability

This operation is available in all marketplaces.

Throttling

The GetOrder operation has a maximum request quota of six and a restore rate of one request every minute. For definitions of throttling terminology, see Orders API.

Request parameters

Name Description Required Values
AmazonOrderId A list of AmazonOrderId values. An AmazonOrderId is an Amazon-defined order identifier, in 3-7-7 format. Yes Maximum: 50

Type: xs:string

Response elements

Name Description Required Values
Orders A list of orders. Yes Type: List of Order

Examples

Example query request

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

Show example code Hide example code

https://mws.amazonservices.jp/Orders/2013-09-01
  ?AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2
  &Action=GetOrder
  &AmazonOrderId.Id.1=902-3159896-1390916
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
  &SellerId=A2986ZQ066CH2F
  &Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &LastUpdatedAfter=2017-02-01T18%3A12%3A21
  &Timestamp=2017-02-05T18%3A12%3A21.687Z
  &Version=2013-09-01

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetOrderResponse xmlns="https://mws.amazonservices.com/
    Orders/2013-09-01">
    <GetOrderResult>
        <Orders>
            <Order>
                <AmazonOrderId>902-3159896-1390916</AmazonOrderId>
                <PurchaseDate>2017-01-20T19:49:35Z</PurchaseDate>
                <LastUpdateDate>2017-01-20T19:49:35Z</LastUpdateDate>
                <OrderStatus>Pending</OrderStatus>
                <FulfillmentChannel>MFN</FulfillmentChannel>
                <NumberOfItemsShipped>0</NumberOfItemsShipped>
                <NumberOfItemsUnshipped>0</NumberOfItemsUnshipped>
                <PaymentMethod>Other</PaymentMethod>
                <PaymentMethodDetails>
                    <PaymentMethodDetail>CreditCard</PaymentMethodDetail>
                    <PaymentMethodDetail>GiftCerificate</PaymentMethodDetail>
                </PaymentMethodDetails>
                <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>>
                <ShipmentServiceLevelCategory>Standard
                </ShipmentServiceLevelCategory>
                <OrderType>StandardOrder</OrderType>
                <EarliestShipDate>2017-01-20T19:51:16Z</EarliestShipDate>
                <LatestShipDate>2017-01-25T19:49:35Z</LatestShipDate>	
                <IsBusinessOrder>false</IsBusinessOrder>
                <IsPrime>false</IsPrime>
                <IsPremiumOrder>false</IsPremiumOrder>
                <IsGlobalExpressEnabled>false</IsGlobalExpressEnabled>
                <IsAccessPointOrder>false</IsAccessPointOrder>
            </Order>
        </Orders>
    </GetOrderResult>
    <ResponseMetadata>
        <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId>
    </ResponseMetadata>
</GetOrderResponse>

↑ Top

Related topics