TransactionLookup

The TransactionLookup operation returns information about up to ten purchases that have already taken place. Transaction IDs are created whenever a purchase request is made by a customer.

For a specified transaction ID, TransactionLookup returns:

Price details
Sale date
Shipping details
Seller details
Item’s condition

For privacy reasons, this operation does not return information about the customer who purchased the items.

Availability

Sample Requests

Use TransactionLookup in the following way:

Look up purchase details for TransactionId 002-7777777-7138425.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService
&AWSAccessKeyId=[AWS Access Key ID]
&Operation=TransactionLookup
&TransactionId=002-7777777-7138425

The response to this request is shown in, Response to Sample Request, below.

Request Parameters

The following table describes the request parameters for TransactionLookup. Parameter names are case sensitive.

Parameter Definition Required

Parameter	Definition	Required
`TransactionId`	A number that uniquely identifies a transaction. The retail web site calls this number the Order number. Type: Number, for example, 002-7777777-7138425 Default: None	Yes
`ResponseGroup`	Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas.	No	Default: TransactionDetails

TransactionId

A number that uniquely identifies a transaction. The retail web site calls this number the Order number.

Type: Number, for example, 002-7777777-7138425

Default: None

Yes

ResponseGroup

Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas.

Default: TransactionDetails

TransactionLookup also accepts the parameters that all operations can use. For more information, see, Common Request Parameters

Response to Sample Request

The following XML is a snippet of the full response to the first sample request above.

<Transaction>
  <TransactionId>002-7777777-7138425</TransactionId> 
  <SellerId>AT9999999999R</SellerId> 
  <Condition>Complete</Condition> 
  <TransactionDate>2005-06-08T19:19:27</TransactionDate> 
  <TransactionDateEpoch>1118258367</TransactionDateEpoch> 
  <SellerName>Amazon.com</SellerName> 
  <Totals>
    <Total>
      <Amount>1879</Amount> 
     <CurrencyCode>USD</CurrencyCode> 
     <FormattedPrice>$18.79</FormattedPrice> 
    </Total>
    <Subtotal>
      <Amount>1485</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
     <FormattedPrice>$14.85</FormattedPrice> 
    </Subtotal>
    <Tax>
      <Amount>144</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$1.44</FormattedPrice> 
    </Tax>
    <ShippingCharge>
      <Amount>399</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$3.99</FormattedPrice> 
    </ShippingCharge>
    <Promotion>
      <Amount>149</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$1.49</FormattedPrice> 
    </Promotion>
  </Totals>
  <TransactionItems>
    <TransactionItem>
      <TransactionItemId>jooloslsnpl</TransactionItemId> 
      <Quantity>1</Quantity> 
      <UnitPrice>
        <Amount>1485</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$14.85</FormattedPrice> 
      </UnitPrice>
      <TotalPrice>
        <Amount>1485</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$14.85</FormattedPrice> 
      </TotalPrice>
  </TransactionItem>
</TransactionItems>
<Shipments>
  <Shipment>
    <Condition>Shipped</Condition> 
    <ShipmentItems>
      <TransactionItemId>jooloslsnpl</TransactionItemId> 
    </ShipmentItems>
  </Shipment>
</Shipments>
</Transaction>
</Transactions>

Response Tags

The following table describes the default response tags included in TransactionLookup responses.

Element Tag	Definition
`Amount`	Price of the item in terms of the lowest currency denomination, for example, pennies.
`Condition`	Specifies an item's condition. If Condition is set to “All,” a separate set of responses is returned for each valid value of Condition. Valid values are New (default), Used, Collectible, Refurbished, and All. When the Availability parameter is set to "Available," the Condition parameter cannot be set to "New."
`CurrencyCode`	ISO 4217 three-letter code that specifies the locale's currency.
`FormattedPrice`	The price to display to the customer.
`Promotion`	Container for promotion discount.
`Quantity`	Number of items
`SellerId`	An alphanumeric token that uniquely identifies a seller.
`SellerName`	String that is the seller’s name.
`Shipment`	Container for information relating for one shipment to a buyer. here can be multiple shipments to one buyer in one transaction, for example, when one item is ready to ship before another.
`ShipmentItems`	Container for all items that were shipped to buyer in one shipment.
`ShippingCharge`	Cost associated with shipping.
`Subtotal`	Total cost of the items in the transaction. This cost does not include tax, shipping charges, or promotions.
`Total`	Total cost the customer paid in the transaction. This cost includes tax, shipping charges, or promotions. This is a container for Amount, CurrencyCode, and FormattedPrice.
`Totals`	This is a container for Total, Subtotal, Tax, ShippingCharges, and Promotions.
`TransactionDate`	Date when order was created.
`TransactionDateEpoch`	Date in epoch seconds when order was created.
`TransactionId`	An alphanumeric token that uniquely identifies the transaction. This ID is called the Order Number on the retail web site in Your Account.
`TransactionItem`	Transaction data for one item in the transaction. Container for TransactionItemId, quantity, and UnitPrice.
`TransactionItemId`	An alphanumeric token that uniquely identifies an item in the transaction.
`TransactionItems`	Container for one or more TransactionItem(s).
`UnitPrice`	Price for a single item.

For more information about the parent elements of these tags, see the appropriate response group in Response Groups.

Related Operations

None