Retrieve a market bid
Retrieve one live bid by its opaque code, with the wine, net price, quantity and fulfilment requirements in one object.
A missing, expired or malformed bid returns the same BID_NOT_FOUND / 404. Your own bids are returned, with is_own_bid set.
How this call works
4 STEPSYour server
Pass the code exactly as it was given
GET /market/bids/{code}Codes are opaque: do not parse one, do not shorten one, and URL-encode it as a single path segment.
Cru
Cru returns the bid, flattened
The wine and the price level arrive together in data.bid rather than nested, because there is only ever one of each here.
KEEP
price, quantity, expires_at, requirementsYour server
Treat 404 as “no longer available”
Missing, expired, filled and malformed all return the same BID_NOT_FOUND / 404. None of them are worth distinguishing: in every case, go back to the book.
Your server
Check the requirements against your stock
landed_stock_only and deliverable_warehouses decide whether what you hold can fill this bid. Only verified stock can be sold into a bid.
KEEP
requirements
Path parameter
REQUIRED| codestring | The opaque code of a bid in GET /market/bids. URL-encode it as a single path segment. |
Response fields
200 OKFields returned in data.bid: the wine and the bid together.
lwin18string
The 18-digit LWIN: wine, vintage and pack together. Match on all 18 digits.
wine_namestring | null
Cru’s name for the wine.
vintageinteger | null
The vintage year. 1000 means non-vintage.
pack_sizestring | null
Pack format, for example 6x75cl.
product_urlstring | null
The wine’s page on the Cru storefront for the market you called.
currencystring
ISO 4217 currency of every price in this market: the currency of the market you called.
codestring
Opaque bid code: BID- and 43 more characters. Do not parse it. Your own bids carry the same code here and in /bids.
pricenumber | null
Net price per unit — what a seller receives after Cru’s commission — converted into the market’s currency at today’s rate, to 2 decimal places. null in the rare case Cru cannot price the bid.
quantityinteger
Units the bid still wants.
is_own_bidboolean
True when the bid is yours. Your own bids are listed, but you cannot sell into one.
expires_atdate | null
YYYY-MM-DD. For bids Cru carries from other venues this is always set two days ahead, not taken from the venue.
updated_atdatetime | null
Last change, RFC 3339 UTC.
requirementsobject
What stock must satisfy to fill the bid: condition_status (always verified — only Verified stock can fill a bid), landed_stock_only, and deliverable_warehouses — the warehouse codes whose stock can fill it.
Errors
An unavailable bid returns BID_NOT_FOUND / 404, and any query parameter VALIDATION_UNKNOWN_PARAMETER / 400. Missing or invalid credentials return AUTH_INVALID_CREDENTIALS / 401. A credential without market:read gets AUTH_INSUFFICIENT_SCOPE / 403. View all error codes →