Skip to main content

This type defines the fields that describe a listing that is in a promotion.

Type that uses ListingDetail

ItemsPagedCollection

Call that uses ListingDetail

Fields

Field
Type
Description
currentPrice
The container that returns the current price of the listing.
freeShipping
If set to true, the seller pays for the shipping (or that the item is marked for local pickup only) In this case, the listing does not have an associated shipping cost for the first listed domestic-shipping option (even if the first domestic-shipping option specifies a flat-rate or calculated shipping option). If false, the buyer is required to pay for a flat-rate or calculated cost shipping service.
inventoryReferenceId
The seller's inventory reference ID for a listing. Also known as the "SKU" or "custom label," an inventory reference ID is either the ID of the listing or, if the listing has variations (such as a shirt that's available in multiple sizes and colors), the ID of the parent listing.
inventoryReferenceType
Indicates the type of the inventoryReferenceId, which can be either a single-SKU or a multi-SKU listing (INVENTORY_ITEM and INVENTORY_ITEM_GROUP, respectively).

Note: This value is not currently returned in the response.
listingCategoryId
The ID of the category that listing belongs to. The ID is a numeric and unique identifier for the category that is assigned by eBay.
listingCondition
An eBay-assigned value that indicates condition of the associated item. For more information, see Item condition ID and name values.
listingConditionId
The ID of the condition associated with the item. For more information, see Item condition ID and name values.

Note: This value is not currently returned in the response.
listingId
A unique eBay-assigned ID that is generated when the item is listed.
listingPromotionStatuses
A list of the status values assigned to the item and the date that each new status was assigned.
quantity
The number of items being sold in the listing.
storeCategoryId
Store CategoryId (if any) that to which the listing belongs. This field is blank if there is no seller Store category ID.
title
The seller-defined title of the listing that a seller can use to identify the item. This label is not displayed in end-user flows.