/Bid POST

Allows a user to bid on an item. If confirmation is needed, a link will be returned requesting the bid be resubmitted for confirmation.

URL
/Bid
Verb
POST

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 body of the request.

Parameter Data Type Valid Values Description
ItemID integer positive # The item id for the item to bid on.
Amount decimal positive # The maximum bid for the item. AutoBid will bid on the user's behalf up to the maximum bid which is kept secret from other users.

Output

If the bid is markedly higher than the current bid or your bid is higher than the BuyNow! price for this item, you will receive a 302 Redirect which will contain a Link to confirm that the bid is correct.

If the bid does not result in you becoming the winning bidder, you will receive a 409 Conflict and a Message Response indicating reasons.

If your bid results in you becoming the winning bidder, you will receive a 200 OK and a Message Response indicating success.

Links

Rel Description Condition
confirmbid Confirm the bid A Message Response will be returned and contain this link only when the bid seems much higher than it should or if the bid meets or exceeds the BuyNow! Price.
item View the item A Message Response will contain this link when a confirm bid is needed, you've been outbid by autobid, the bid doesn't meet the reserve price or any other bidding related issue.