marketing APIv1.10.1

ListingDetail

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

Type that uses ListingDetail

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 an individual item or a multi-SKU item (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.

Note: As of September 1, 2021, condition ID 2500 ('Seller Refurbished') is no longer a valid item condition in the Cell Phones & Smartphones category (category ID 9355) for the following marketplaces: US, Canada, UK, Germany, and Australia. This refurbished item condition has been replaced by three new refurbished values, which include 'Excellent - Refurbished' (condition ID 2010), 'Very Good - Refurbished' (condition ID 2020), and 'Good - Refurbished' (condition ID 2030).

Note: In all eBay marketplaces, Condition ID 2000 now maps to an item condition of 'Certified - Refurbished', and not 'Manufacturer Refurbished'. To list an item as 'Certified Refurbished', a seller must be pre-qualified by eBay for this feature.
listingConditionId
The ID of the condition associated with the item. For more information, see Item condition ID and name values.

Note: As of September 1, 2021, condition ID 2500 ('Seller Refurbished') is no longer a valid item condition in the Cell Phones & Smartphones category (category ID 9355) for the following marketplaces: US, Canada, UK, Germany, and Australia. This refurbished item condition has been replaced by three new refurbished values, which include 'Excellent - Refurbished' (condition ID 2010), 'Very Good - Refurbished' (condition ID 2020), and 'Good - Refurbished' (condition ID 2030).

Note: In all eBay marketplaces, Condition ID 2000 now maps to an item condition of 'Certified - Refurbished', and not 'Manufacturer Refurbished'. To list an item as 'Certified Refurbished', a seller must be pre-qualified by eBay for this feature.
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.