Returns a user's bidding 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 - Winning 2 - Not Winning |
Status of the won 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 - MyMaxBid 4 - CurrentBid 5 - ItemID |
The field to sort on. Default = 0 - EndingDate |
SortOrder | integer | 0 - Ascending 1 - Descending |
Sort direction. Default = 0 - Ascending |
TimeFrame | integer | 0 - ViewCurrent 3 - ViewGoingGoingGone 4 - ViewNewCalendarToday 5 - ViewEndingCalendarToday 6 - ViewNewLast24 7 - ViewNewLast48 15 - ViewNewSinceLastVisit 16 - ViewEndingNext24 |
This sets the time frame to search for. Default = 0 - ViewCurrent. |
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 |
---|---|---|---|
CurrentBid | decimal | positive # | The current bid amount on the item. |
CanOffer | boolean | true/false | Does the Item accept Offers? |
HasBuyNow | boolean | true or false | Indicates whether or not a "Buy Now" price was specified |
BuyNowPrice | decimal | positive # | The "Buy Now" price for an item, if applicable. Will be 0 if a "Buy Now" price is not set |
EndingDateTime | datetime | A valid datetime | The ending date for the item in UTC. |
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 # | ItemID of the item. |
IsWinningBidder | boolean | true/false | Is the current user the high bidder on the item, and if the item has a reserve price, does that user's bid exceed the reserve price? |
MyMaxBid | decimal | positive # | The max bid for the current user and item. |
Seller | User Summary | User Summary | The User Summary for 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 | non null string | The Item Title. |
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 |