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 orders based on the AmazonOrderId values that you specify.
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.
The following tables show when the GetOrder operation returns buyer contact information (BuyerEmail, BuyerName, ShippingAddress) and charge information (OrderTotal).
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 |
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 |
This operation is available in all marketplaces.
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.
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 |
Name | Description | Required | Values |
---|---|---|---|
Orders | A list of orders. | Yes | Type: List of Order |
For information about standard request requirements, see Required request parameters.
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
For information about standard response formatting, see Response format.
<?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>