/ItemsWatched GET

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

URL
/ItemsWatched
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

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
ItemStatus integer 0 - All

1 - Active

2 - Ended
Timeframe for the watched items. Default = 0 - All
Keywords string Keywords for search The keywords to use for search
SellerName string string Username or Email address of the seller you want to filter by.
Sort integer 0 - EndingDate

1 - Thumbnail

2 - Title

3 - Price

4 - Bids

5 - Seller

6 - ItemID
The field to sort on. Default = 0 - EndingDate
SortOrder integer 0 - Ascending

1 - Descending. Default = 0 - Ascending
Sort direction.
TimeFrame integer 0 = View All Available = Default

3 = View Going Going Gone

4 = View New Calendar Today

5 = View Ending Calendar Today

6 = View New Last 24

7 = View New Last 48

8 = View Ended Last 24

9 = View Ended Last 48

10 = View Ended Last Week

11 = View Ended Last 2 Weeks

12 = View Ended Last 30 Days

13 = View Ended Last 60 Days

14 = View Ended Last 90 Days

16 = View Ending Next 24

This parameter looks for watched items in the various timeframes

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
CanOffer boolean true/false Does the Item accept Offers?
Quantity integer positive # Number of items available to bid on.
Bids integer positive # Number of bids the item has.
EndingDate datetime Valid ISO 8601 DateTime format The ending date time of the item in UTC.
HasImmediateCheckout boolean true/false Is the item eligible for immediate checkout?
HasBuyNow boolean true/false Is the item eligible to buy now?
HasColor boolean true/false Whether or not this item has the paid Colored Title feature.
HasPictures boolean true/false Does the item have pictures?
HasReserve boolean true/false Does the item have reserve price?
HasReserveBeenMet boolean true/false Has the reserved been meet on this item?
IsTitleBoldface boolean true/false Whether or not this item's title is bold.
IsFeaturedItem boolean true/false Is this item featured?
IsFixedPrice boolean true/false Is this item a fixed price item?
ItemID integer positive # ItemID of the item.
Price decimal positive # The current cost of an item.
Seller User Summary User Summary A user object containing User Summary information
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
TimeLeft Duration Valid ISO 8601 Duration format The time remaining for an item.
Title string string The title of the item.
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.

Links

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