Allows a user to bid on an item. If confirmation is needed, a link will be returned requesting the bid be resubmitted for confirmation.
| 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 body of the request.
| Parameter | Data Type | Valid Values | Description |
|---|---|---|---|
| ItemID | integer | positive # | The item id for the item to bid on. |
| Quantity | integer | positive # | The quantity the user wishes to purchase. |
| Price | decimal | positive # | The price of a single item. NOTE: If the price does not match what is in our system, an error will be thrown. |
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 FixedPrice results in you successfully purchasing the item, you will receive a 200 OK and a Message Response indicating success.
| Rel | Description | Condition |
|---|---|---|
| item | View the item |