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 > Bidders
A bidder is a user registered for a specific sale.
The Bidders API is restricted to authorized applications/users.
Users can retrieve bidders by following the bidders link from root.
curl -v "https://api.artsy.net/api/bidders?user_id=USER_ID" -H "X-Access-Token: ACCESS_TOKEN"
This endpoint accepts the following parameters.
Name | Value |
---|---|
sale_id | Applicable Auction (sale) ID. |
The response is a paginated result with embedded bidders.
{ "total_count" : 1, "_links" : { "self" : { "href" : "https://api.artsy.net/api/bidders?sale_id=..." }, "next" : { "href" : "https://api.artsy.net/api/bidders?cursor=...&sale_id=..." } }, "_embedded" : { "bidders" : [ { "id":"...", ... } ] } }
A request without a sale_id
will receive a paginated list of all bidders.
Authorized users and applications can retrieve a specific bidder by ID by rendering the "bidder" link template from root.
curl -v "https://api.artsy.net/api/bidders/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
Key | Target |
---|---|
self | The bidder resource. |
sale | The sale of the bidder |
user | The user of the bidder |
user_detail | The user detail of the bidder |