eBay Trading APIVersion 1331

GetOrderTransactionsRequestType ( AbstractRequestType )

The base request type for the GetOrderTransactions call. This call retrieves detailed information about one or more orders or order line items created (or modified) in the last 90 days.

Note: This call is deprecated and will be decommissioned on January 31, 2024. No further updates are planned for this API during the deprecation period. Developers have the option of migrating to the GetOrders call in the Trading API, or the getOrders method of the Fulfillment API. Please note that the Fulfillment API only returns paid orders, so if your use case calls for retrieving both paid and unpaid orders, we recommend migrating to the GetOrders call in the Trading API.
Unlike GetOrders, which can be used to retrieve specific orders, or orders created (or modified) within a specific time period, the GetOrderTransactions call only supports the retrieval of specific orders and/or order line items.

Call that uses GetOrderTransactionsRequestType:


IncludeFinalValueFees ( boolean ) [0..1]
This field is included and set to true if the user wants to view the Final Value Fee (FVF) for all order line items in the response. The Final Value Fee is returned in the Transaction.FinalValueFee field. The Final Value Fee is assessed right after the creation of an order line item.

See the Selling fees help page for more information about how Final Value Fees are calculated.
See the Field Index to learn which calls use IncludeFinalValueFees.

ItemTransactionIDArray ( ItemTransactionIDArrayType ) [0..1]
This container is used if the seller wants to retrieve for one or more order line items. An ItemTransactionID container is required for each order line item that is to be retrieved. An order line item can be identified with an ItemID/TransactionID pair, with an OrderLineItemID value, or with a SKU value (if a SKU is defined for the order line item).
See the Field Index to learn which calls use ItemTransactionIDArray.

OrderIDArray ( OrderIDArrayType ) [0..1]
This container is used if the seller wants to search for one or more orders. An OrderID field is required for each order that is to be retrieved. Up to 20 OrderID fields can be used.

Note: As of June 2019, eBay has changed the format of order identifier values. The new format is a non-parsable string, globally unique across all eBay marketplaces, and consistent for both single line item and multiple line item orders. Unlike in the past, instead of just being known and exposed to the seller, these unique order identifiers will also be known and used/referenced by the buyer and eBay customer support.

For developers and sellers who are already integrated with the Trading API's order management calls, this change shouldn't impact your integration unless you parse the existing order identifiers (e.g., OrderID or OrderLineItemID), or otherwise infer meaning from the format (e.g., differentiating between a single line item order versus a multiple line item order). Because we realize that some integrations may have logic that is dependent upon the old identifier format, eBay is rolling out this Trading API change with version control to support a transition period of approximately 9 months before applications must switch to the new format completely.

During the transition period, for developers/sellers using a Trading WSDL older than Version 1113, they can use the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header in API calls to control whether the new or old OrderID format is returned in call response payloads. To get the new OrderID format, the value of the X-EBAY-API-COMPATIBILITY-LEVEL HTTP header must be set to 1113. During the transition period and even after, the new and old OrderID formats will still be supported/accepted in all Trading API call request payloads. After the transition period (which will be announced), only the new OrderID format will be returned in all Trading API call response payloads, regardless of the Trading WSDL version used or specified compatibility level.

Note: For sellers integrated with the new order ID format, please note that the identifier for an order will change as it goes from unpaid to paid status. Sellers can check to see if an order has been paid by looking for a value of 'Complete' in the CheckoutStatus.Status field in the response of GetOrders or GetOrderTransactions call, or in the Status.CompleteStatus field in the response of GetItemTransactions or GetSellerTransactions call. Sellers should not fulfill orders until buyer has made payment. When using a GetOrders or GetOrderTransactions call to retrieve specific order(s), either of these order IDs (paid or unpaid status) can be used to retrieve an order.
See the Field Index to learn which calls use OrderIDArray.

Not used by any call.

Note: This field should no longer be used since its sole purpose was to allow the seller to filter between eBay orders and Half.com orders, and the Half.com site no longer exists.
See the Field Index to learn which calls use Platform.