Documentation > Resources > Bids

Bids API

An Bid is created while processing a bidder position (following that Auction's rules regarding increments, reserve pricing and so on).

For more information about how Artsy's bidding logic and models, see our blog post on the topic.

The Bids API is restricted to authorized applications/users.

Retrieving a Bid

Users can retrieve a specific bid by ID by rendering the "bid" link template from root.

curl -v "https://api.artsy.net/api/bids/{id}" -H "X-XAPP-Token:..."

Bid JSON Format

Key Description
created_at Timestamp of when the record was created.
id Unique id.
amount_cents Bid Amount
display_amount_dollars Display amount in currency
number Bid ordered within all lot bids
cancelled Bid was cancelled
boosted_to_reserve True if bid was boosted to meet lot's reserve price.

Links

Key Target
self The bid resource.
position The source bidder position
artwork The associated artwork
sale The sale where the bid was placed