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