Returns a user's watched items as a List Response.
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. |
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 |
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
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? |
CreditCardUpChargePercent | decimal | postive # | The percent in decimal form of the credit card up charge. Will be null if not applicable. |
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 this reserve been met? (Will be false if HasReserve is false) |
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? |
IsFreeShipping | boolean | true/false | Does this item have free shipping available? |
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. |
Rel | Description | Condition |
---|---|---|
self | The item details | |
feedback | View the Seller's feedback summary | |
selleritems | Seller's other items for sale |