Skip to main content

This type defines the fields for the sold items sales history information.

Type that uses ItemSales

SalesHistoryPagedCollection<ItemSales>

Call that uses ItemSales

Fields

Field
Type
Description
additionalImages
array of Image
An array of containers with the URLs for the images that are in addition to the primary image. The primary image is returned in the image.imageUrl field.
adultOnly
This indicates if the item is for adults only. For more information about adult-only items on eBay, see Adult items policy for sellers and Adult-Only items on eBay for buyers.
bidCount
This integer value indicates the total number of bids that have been placed for an auction item. This field is only returned for auction items.
buyingOptions
array of string
A comma separated list of the purchase options available for the item, such as FIXED_PRICE, AUCTION.
  • FIXED_PRICE - Returned for fixed-price items (non-auction)
  • AUCTION - Returned for auction items without Buy It Now feature
  • FIXED_PRICE and AUCTION - Returned for auction items enabled with the Buy It Now feature
Code so that your app gracefully handles any future changes to this list.
categories
array of Category
This container returns the primary category ID of the item, as well as the secondary category if the item was listed in two categories.
condition
The text describing the condition of the item, such as New or Used. For a list of condition names, see Item Condition IDs and Names.

Code so that your app gracefully handles any future changes to this list.
conditionId
The identifier of the condition of the item. For example, 1000 is the identifier for NEW. For a list of condition names and IDs, see Item Condition IDs and Names.

Code so that your app gracefully handles any future changes to this list.
epid
An ePID is the eBay product identifier of a product from the eBay product catalog. This indicates the product in which the item belongs.
image
The URL to the primary image of the item.
itemAffiliateWebUrl
The URL to the View Item page of the item, which includes the affiliate tracking ID. This field is only returned if the eBay partner enables affiliate tracking for the item by including the X-EBAY-C-ENDUSERCTX request header in the method.
itemGroupHref
The HATEOAS reference of the parent page of the item group. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc.

Note: This field is returned only for item groups.
itemGroupType
Indicates the item group type. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc.

Currently, only the SELLER_DEFINED_VARIATIONS group type is supported and indicates that this is an item group created by the seller.

Note: This field is returned only for item groups.

Code so that your app gracefully handles any future changes to this list.
itemHref
The URI of the item.
itemId
The unique RESTful identifier of the item.
itemLocation
This container returns the postal code and country of the location of the item.
itemWebUrl
The URL to the View Item page of the item.
lastSoldDate
The date the last item was purchased within the last 90 days. The totalSoldQuantity returns the total number of items that were sold. This field returns the date the last item in that group was sold.
lastSoldPrice
The sold price of the last item purchased within the last 90 days.

The totalSoldQuantity returns the total number of items that were sold. This field returns the date the last item in that group was sold.

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.
seller
This container returns basic information about the seller of the item, such as name, feedback score, etc.
thumbnailImages
array of Image
An array of thumbnail images for the item.
title
The seller-created title of the item.

Maximum Length: 80 characters
totalSoldQuantity
The total number of this item that have been sold.

Got thoughts? Click the feedback button – your insights help us improve!