/ItemsUnsold GET

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

URL

/ItemsUnsold

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 - Not Relisted 2 - Relisted	Status of the sold items. Default = 0 - All
Sort	integer	0 -BidCount, 1 - BuyNowPrice, 3 - EndDate, 4 - FixedPrice, 5 - HighBid, 6 - ItemID, 7 - Title, 8 - Quantity, 9 - Relisted, 10 - ReservePrice, 11 - SerialNumber, 12 - SKU, 13 - StartDate, 14 - StartingBid, 15 - StartingPrice, 17 - UPC, 18 - WatchersCount, 19 - ExpirationDate	The field to sort on. Default = 3 - EndDate
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 18 - ViewExpiredLast90Days	Using this parameter requires a valid X-AccessToken authentication header. This sets the time frame to search for. Default = 12 - ViewEndedLast30Days.
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
CategoryID	integer	positive #	The CategoryID 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
BidCount	integer	positive #	Number of bids on the item
BuyNowPrice	decimal	positive #	The BuyNow price for the item
CategoryID	integer	positive #	The CategoryID belonging to the item
EndDate	datetime	Valid ISO 8601 DateTime format	Date the auction ended
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.
HighBid	decimal	positive #	The current bid amount for the item
IsTitleBoldface	boolean	true/false	Whether or not this item's title is bold.
ItemID	integer	positive #	ID of the item sold
Quantity	integer	positive #	The quantity purchased
Relisted	boolean	true/false	Indicates if the item has been relisted
ReservePrice	decimal	positive #	The reserve price on the item
SerialNumber	string	string	The serial number of the item
SKU	string	string	The SKU of the item
StartDate	datetime	Valid ISO 8601 DateTime format	Date the auction started
StartingBid	decimal	positive #	The amount the bidding started at for auctions
StartingPrice	decimal	positive #	The amount the item started selling at
SubTitle	string	string	The subtitle of an item.
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
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.
UPC	string	string	The item's UPC
WatchersCount	integer	positive #	Number of users watching the item
ExpirationDate	datetime	Valid ISO 8601 DateTime format	The expiration date and time of the listing

Links

Rel	Description	Condition
self	The item details