/ItemsSold GET

Returns a user's sold items as a List Response.

URL

/ItemsSold

Verb

GET

Headers

Header	Data Type	Valid Values	Required	Description
Content-Type	string	application/json	YES	The format your data will be sent to our site.
X-DevKey	string	string	YES	The devkey assigned to the developer.
X-AccessToken	string	string	YES	The token acquired from a POST to Users/AccessToken.

Input

NOTE: Variables to place in the query string of the request.

Parameter	Data Type	Valid Values	Description
ItemStatus	integer	0 - All 1 - Awaiting Payment 2 - Awaiting FFL 3 - Awaiting Shipping 4 - Not Relisted 5 - Relisted 6 - Received Payment 7 - Received FFL 8 - Sent Item	Status of the sold items. Default = 0 - All
Sort	integer	0 - Thumbnail 1 - Title 2 - Buyer Name 3 - Qty 4 - SaleDate 5 - SalePrice 6 - TotalPrice 7 - ItemID 8 - Serial Number 9 - SKU 10 - Payment Status (sorts by TotalSentDate then by SellerReceivedTotalDate) 11 - Feedback Status (sorts by BuyerPostedFeedback then by SellerPostedFeedback) 12 - FFL Status (sorts by BuyerSentFFLDate then by SellerReceivedFFLDate) 13 - Shipping Status (sorts by SellerSentItemDate then by BuyerReceivedItemDate) 14 - Relisted 15 - Expiration Date	The field to sort on. Default = 4 - SaleDate
SortOrder	integer	0 - Ascending 1 - Descending	Sort direction. Default = 1 - Descending
TimeFrame	integer	1 - ViewCompleted 8 - ViewEndedLast24 9 - ViewEndedLast48 10 - ViewEndedLastWeek 11 - ViewEndedLast2Weeks 12 - ViewEndedLast30Days 13 - ViewEndedLast60Days 14 - ViewEndedLast90Days	Using this parameter requires a valid X-AccessToken authentication header. This sets the time frame to search for. Default = 12 - ViewEndedLast30Days.
BuyerUserID	integer	positive #	The UserID of the buyer for the item
BuyerUserName	string	string	The User Name of the buyer for the item
SerialNumber	string	string	The serial number of the item
SKU	string	string	The SKU of the item
ItemID	integer	positive #	The ItemID of the item
Keywords	string	Any string	A keyphrase to search for in the item's title, subtitle, or characteristics

Optional PagingParameters

Output

If there are no errors with the input parameters, this call will respond with a 200 OK and the following data as serialized JSON

Parameter	Data Type	Valid Values	Description
BuyNowPrice	decimal	positive #	The "Buy Now" price for an item, if applicable. Will be 0 if a "Buy Now" price is not set
CurrentBid	decimal	positive #	The current bid amount for the item
BidCount	integer	positive #	Number of bids on the item
Buyer	User Summary	User Summary	The Buyer of the item
BuyerPostedFeedback	boolean	true/false	Indicates if the buyer has posted feedback
BuyerReceivedItemDate	datetime	Valid ISO 8601 DateTime format	The date the buyer indicated that the item has been received
BuyerSentFFLDate	datetime	Valid ISO 8601 DateTime format	The date the buyer indicated that FFL information has been sent
BuyerSentPaymentDate	datetime	Valid ISO 8601 DateTime format	The date the buyer indicated that payment has been sent
FixedPrice	decimal	positive #	The fixed price value of the item
HasColor	boolean	true/false	Whether or not this item has the paid Colored Title feature.
IsTitleBoldface	boolean	true/false	Whether or not this item's title is bold.
ItemID	integer	positive #	ID of the item sold
OrderID	integer	number >= 0	Order ID of the order associated with the item (0 if the item did not sell)
OrderStatus	integer	positive #	Current status of the order associated with the item 1 - Pending Seller Review 2 - Pending Buyer Confirmation 3 - Pending Payment Received 4 - Pending Shipment 5 - Complete 6 - Canceled 7 - Pending Buyer Review 10 - On Layaway 11 - Payment In Process 12 - Returned
Quantity	integer	positive #	The quantity purchased
Relisted	boolean	true/false	Indicates if the item has been relisted
RelistPrice	decimal	positive #	The price to relist the item
ReservePrice	decimal	positive #	The reserve price on the item
SaleDate	datetime	Valid ISO 8601 DateTime format	Date the item was purchased
SalePrice	decimal	positive #	The amount the item sold for
Seller	User Summary	User Summary	The Seller of the item
SellerPostedFeedback	boolean	true/false	Indicates of the seller has posted feedback
SellerReceivedPaymentDate	datetime	Valid ISO 8601 DateTime format	The date the seller indicated that payment has been received
SellerReceivedFFLDate	datetime	Valid ISO 8601 DateTime format	The date the seller indicated that FFL information has been received
SellerSentItemDate	datetime	Valid ISO 8601 DateTime format	The date the seller indicated that the item has been shipped
SerialNumber	string	string	The serial number of the item
SKU	string	string	The SKU of the item
SubTitle	string	string	The subtitle of an item.
Title	string	string	Title of the item sold. NOTE: The old property ItemTitle is deprecated and will be removed soon.
TitleColor	string	Valid hex color strings (ex: #000000)	The color of the item title. If the paid feature isn't available, black (#000000) will be returned.
ThumbnailURL	string	A fully qualified url to an image file	The location of the image file to be used as the thumbnail for the item
TotalPrice	decimal	positive #	Total amount for the item including cost for multiple quantities, shipping, and sales tax
ExpirationDate	datetime	Valid ISO 8601 DateTime format	The expiration date and time of the listing

Links

Rel	Description	Condition
self	The item details