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

Bidders API

A bidder is a user registered for a specific sale.

The Bidders API is restricted to authorized applications/users.

Retrieving Bidders

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.

Retrieving a Bidder

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"

Bidder JSON Format

error: the server responded with status 404

Links

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