Please note, we are in the process of retiring the public api. The public api, as well as its documentation and playground, will remain available until July 28th, 2025. This change will not affect integration partners using our partner api.


If you're an Artsy partner gallery, reach out to your Artsy Liaison or contact our Support team for assistance.

Public API 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: XAPP_TOKEN"

Bid JSON Format

error: the server responded with status 404

Links

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