List warehouses
The five Cru warehouses wine can be delivered into: codes, addresses, bond references, delivery instructions, and whether your inbond wine sells through each.
A bid’s deliverable_warehouses, an offer’s warehouse_code and the warehouse.deliverable_warehouse_code of a listing or a portfolio line all use these five codes, and so does the warehouse.current_location_code of wine stored in one. Warehouses outside Cru, where your wine may be stored, are GET /warehouses/inbond: an inbond_address_id is never a warehouse_code.
Request parameters
This endpoint takes no parameters, and is not paged.
Response fields
200 OKdata.warehouses is an array, always in the same order: UK, HK, SG, FR, US. The last three fields are yours: what each warehouse means for wine you hold outside Cru.
Each item in warehouses[]
codestring
UK_DRAK, HK_KERRY, SG_TOLL, FR_DARTESS, US_NAPA.
namestring
The warehouse’s short name.
marketstring | null
The Cru site the warehouse belongs to, such as uk.
addressobject
street, city, region, postcode and country (an ISO country code), each nullable.
phonestring | null
Contact number.
bond_referencesarray<string>
Excise and bond references to quote when delivering in bond.
delivery_instructionsstring | null
Plain text, with line breaks as \n.
sells_your_inbond_wineboolean
Whether wine you hold outside Cru can be sold through it: the warehouse_code values POST /offers and POST /market/bids/{code}/sell accept from you. False on every row for an account not set up for it.
settlement_feenumber | null
Taken from each unit of that wine sold through it, in currency: 0.0 for a corporate account, and null where sells_your_inbond_wine is false.
currencystring
Your market’s currency.
Errors
Missing or invalid credentials return AUTH_INVALID_CREDENTIALS / 401. A credential without meta:read gets AUTH_INSUFFICIENT_SCOPE / 403. View all error codes →