Public API Documentation > Resources > Bids
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.
Users can retrieve a specific bid by ID by rendering the "bid" link template from root.
curl -v "https://stagingapi.artsy.net/api/bids/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
| Key | Target |
|---|---|
| self | The bid resource. |
| position | The source bidder position |
| artwork | The associated artwork |
| sale | The sale where the bid was placed |