Skip to main content
POST
Take a bid

Authorizations

Authorization
string
header
required

An API key from Settings, API keys. It starts with rc_live_.

Path Parameters

id
string
required

The lot's id.

Body

application/json

Identify the bidder by bidder_id or by paddle_number.

max_cents
integer
required

THE MOST THEY WOULD PAY, not the price. Bidding goes up on their behalf only as far as this, so a winning bid usually settles below it.

bidder_id
string
paddle_number
integer

Response

The bid was taken.

bid_id
string
item_id
string
auction_id
string
amount_cents
integer

What the lot stands at now. Not the same as max_cents: a bid of $200 against a leader whose maximum is $80 leads at $85, and a bid of $80 against a maximum of $200 does not lead and still moves the lot to $85.

max_cents
integer
leading
boolean

Whether this bidder now holds the lot.

next_bid_cents
integer

What it would take to beat it.

item
object