/ItemsWon GET

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

URL
/ItemsWon
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
CanOffer boolean true/false Returns Items that accept offers if set to true. Returns Items that do not accept offers if set to false
SellerName string string The username or email of the seller
Keywords string string Searchable keywords from the item title and description fields
ItemStatus integer 0 - All

1 - Awaiting Payment

2 - Awaiting Feedback
Status of the won items. Default = 0 - All.
The Awaiting Feedback status refers to buyer leaving Feedback (not the sellers)
Sort integer 0 - Thumbnail

1 - Title

2 - Seller Username

3 - Qty

4 - SaleDate

5 - SalePrice

6 - TotalPrice

7 - ItemID
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.

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
CanOffer boolean true/false Does the Item accept Offers?
EndingDate datetime Valid ISO 8601 DateTime format Ending date for the item in UTC
BidPrice decimal positive # The winning bid amount for 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 won
Quantity integer positive # The quantity purchased
Seller User Summary User Summary The Seller of the item
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 won
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.
TotalPrice decimal positive # Bid Price * Quantity
DidBuyerLeaveFeedback boolean true/false Whether or not the buyer of the item left feedback
DidSellerLeaveFeedback boolean true/false Whether or not the seller of the item left feedback
DidBuyerReceiveItem boolean true/false Whether or not the buyer of the item received the item
DidSellerSendItem boolean true/false Whether or not the seller of the item sent the item
DidBuyerSendFFL boolean true/false Whether or not the buyer of the item sent the FFL
DidSellerReceiveFFL boolean true/false Whether or not the seller of the item received the FFL
DidBuyerSendPayment boolean true/false Whether or not the buyer of the item sent the payment
DidSellerReceivePayment boolean true/false Whether or not the seller of the item received the payment

Links

Rel Description Condition
self The item details
feedback View the Seller's feedback summary
selleritems Seller's other items for sale