Skip to main content

The type that defines the fields for line item information in a purchase order.

Type that uses OrderLineItem

PurchaseOrder

Call that uses OrderLineItem

Fields

Field
Type
Description
addonServices
array of AddonService
An array of add-on services that apply to the order line item.
authenticityVerification
This container is returned for orders that are eligible for eBay's Authenticity Guarantee program. The seller ships Authenticity Guarantee program items to the authentication partner instead of the buyer. If the item is successfully authenticated, the authenticator will ship the item to the buyer.
baseUnitPrice
The cost of a single item in this line item.

Note: The price includes the value-added tax (VAT) for applicable jurisdictions when requested from supported marketplaces. In this case, users must pass the X-EBAY-C-MARKETPLACE-ID request header specifying the supported marketplace (such as EBAY_GB) to see VAT-inclusive pricing. For more information on VAT, refer to VAT Obligations in the EU.
fees
array of Fee
A breakdown of the fees applicable to the line item.
image
The URL of the item's image.
itemId
The identifier of the item.
itemOnHold
When this value is true it indicates that the item has been put on hold due to a violation of eBay Policy.
legacyReference
The container that returns fields to support using the Post Order API for returns and cancellations. For information about what is returned in these fields and how to use the Post Order API, see Using the Post Order API.
lineItemId
The identifier of this line item. This is created by the initiateCheckoutSession for a member and initiateGuestCheckoutSession for a guest calls.
lineItemPaymentStatus
An enumeration value that indicates the payment status of this line item.
lineItemStatus
An enumeration value that indicates the fulfillment state of this line item.

Note: When there is no tracking information, this status will never change from FULFILLMENT_IN_PROGRESS because without tracking information eBay has no way of knowing if the order was delivered.
netPrice
The total cost for the items in this line item taking into account the quantity and applying any seller item discounts, such as Buy 1 Get 1, and any coupon that applies to this item.

Note: This does not include any shipping discounts, shipping costs, or seller adjustments.
orderId
The unique order ID for this line item.

Maximum Length: 40 characters
promotions
array of Promotion
An array of promotions applied to the items in this line item.
quantity
The number of individual items in this line item.
seller
The container for information about the seller offering this item, such as the seller's user name.
shippingDetail
Information about the shipping provider used for this line item.
taxDetails
array of TaxDetail
A container for the tax information for the line item.

Note: The information in this container is only returned when requested from the GB marketplace, when applicable.
title
The seller created title of the item.