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 > Bidder Positions
A bidder creates bidder positions.
The Bidder Positions API is restricted to authorized applications/users.
Users can retrieve a specific bidder position by ID by rendering the "bidder_position" link template from root.
curl -v "https://api.artsy.net/api/bidder_positions/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
| Key | Target |
|---|---|
| self | The bidder position resource. |
| sale_artwork | The sale artwork of the bidder position. |
| sale | The sale of the bidder position. |
| artwork | The artwork of the bidder position. |
| bidder | The bidder of the bidder position. |