Beta

The Partner Trading API v1 is in beta — endpoints and response shapes may still change.

Developers
Cru World Wine
API v1 · REST & MCP
Warehouses

List inbond warehouses

Warehouses outside Cru where your wine may be stored, by inbond_address_id: where wine held outside Cru is now, and what an inbond address points at.

GET/warehouses/inbondLIVE
Required scopemeta:readAuthentication requiredTry it
Not Cru’s own warehouses

This is the Cru website’s “Where is it now?” list. Your listings and portfolio lines in one carry IB_ and its inbond_address_id, such as IB_20, as warehouse.current_location_code. The five Cru warehouses wine is delivered into are GET /warehouses, by warehouse_code: an inbond_address_id is never a warehouse_code.

Request parameters

This endpoint takes no parameters, and is not paged.

Response fields

200 OK

data.inbond_warehouses is an array in the order the Cru website lists them: those in GB, then FR, SG, HK and US, then everywhere else — each group by name — then any you suggested that Cru has not approved yet.

Each item in inbond_warehouses[]

inbond_address_idinteger

What POST /offers and POST /market/bids/{code}/sell take to say where the wine is now, and POST /addresses/inbond to save an address there. Never a warehouse_code.

namestring

The warehouse’s name, such as Seckfords.

companystring | null

The company that runs it.

streetstring | null

Its street address, both lines joined with ", ".

citystring | null

Its town or city.

regionstring | null

Its county, state or region.

postcodestring | null

Its postcode.

countrystring | null

An ISO country code, such as GB.

telephonestring | null

Its phone number.

lcb_site_codestring | null

Its London City Bond site code, such as MM for LCB Melksham. Null for most.

is_bondedboolean

Whether it is bonded. A few are duty-paid storage, which cannot be an inbond address.

pendingboolean

True for one you suggested that Cru has not approved yet: only you see it, and only you can use its inbond_address_id.

Errors

Missing or invalid credentials return AUTH_INVALID_CREDENTIALS / 401. A credential without meta:read gets AUTH_INSUFFICIENT_SCOPE / 403. View all error codes →

UP NEXT Retrieve an inbond warehouse

API credentials

Enter the client key and secret issued by Cru. They are kept for this browser tab’s session — a reload keeps them, closing the tab or clearing them ends them.

Credentials are never included in copied examples, and are redacted from anything the console prints back.

Request API access

Tell us who you are and what you want to build. Cru issues a client key and secret for your organisation, scoped to what you need.

Markets you trade in (choose one or more)

We use what you send here to reply about API access, and for nothing else. Cloudflare Turnstile checks the form for bots (privacy policy).