Documentation > Resources > Bidder Positions

Bidder Positions API

A bidder creates bidder positions.

The Bidder Positions API is restricted to authorized applications/users.

Retrieving a Bidder Position

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:..."

Bidder Position JSON Format

Key Description
id Unique id.
max_bid_amount_cents Max bid in cents.
display_max_bid_amount_dollars Max bid in currency
retracted Whether the bidder position was retracted
created_at Timestamp of when the record was created.
updated_at Timestamp of when the record was last updated.

Links

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.