Retrieve one of your bids
One of your own bids by its code, with how much has matched, its status and expiry. Bids from other venues are not found here.
Path parameter
REQUIRED| codestring | The bid’s opaque code, from GET /bids or POST /bids. URL-encode it as a single path segment. |
Response fields
200 OKFields returned in data.bid.
codestring
Opaque bid code, the same one /market/bids shows for this bid.
client_refstring | null
Your own reference, if you gave one when placing the bid.
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.
pricenumber
Gross price per unit you offered — before Cru’s commission — in the currency of the market you called. A bid placed in another currency is converted at today’s rate, as My Bids on Cru shows it.
currencystring
The currency of the market you called, the same for every bid, so one listing never mixes currencies.
bid_currencystring
The currency the bid was placed in, which its price was converted from.
quantityinteger
Total units bid for.
quantity_matchedinteger
Units matched so far.
quantity_openinteger
Units still open: quantity less quantity_matched while live, otherwise 0.
order_numbersarray<string>
The Cru sales order numbers the bid matched into, oldest first. [] if none.
order_urlsarray<string>
Each order’s page on Cru Markets, in the same order as order_numbers, on the site the bid was placed on (its market), not the one you called.
statusstring
live, matched (awaiting invoice), complete, cancelled, expired or error. A live bid past its expiry reports expired.
renewableboolean
Whether POST /bids/{code}/renew takes the bid now. Your allowance is checked only on renewal.
marketstring | null
The Cru site the bid is on, such as uk or hk: the one it was placed on, or last changed through.
local_onlyboolean
Accepts only stock already on that site.
auto_transferboolean
Moves the wine into your storage on that site when the bid fills.
expires_ondate | null
YYYY-MM-DD.
created_atdatetime | null
RFC 3339 UTC.
updated_atdatetime | null
RFC 3339 UTC.
Errors
A bid that is not yours, or not a Cru bid, returns BID_NOT_FOUND / 404. Missing or invalid credentials return AUTH_INVALID_CREDENTIALS / 401. A credential without bids:read gets AUTH_INSUFFICIENT_SCOPE / 403. View all error codes →