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

Inbond warehouses

Warehouses outside Cru where a customer's wine may be stored: inbond_address_id, name, company, street, city, region, postcode, country, telephone, its lcb_site_code if it has one, and whether it is bonded (is_bonded; a few are duty-paid storage). Give an inbond_address_id to list_for_sale or sell_to_bid to say where wine held outside Cru is now, or to add_inbond_address; listings and portfolio lines in one carry IB_ and it as their warehouse's current_location_code. Warehouses this customer suggested that Cru has not approved yet are included, with pending true. These are not Cru's own warehouses (list_warehouses): an inbond_address_id is never a warehouse_code.

READlist_inbond_warehousesLIVE
Reads, and changes nothing

Marked readOnlyHint, so an assistant may call it without asking the customer first.

Arguments

Takes no arguments.

Returns

STRUCTUREDCONTENT

inbond_warehouses: inbond_address_id, name, company, street, city, region, postcode, country, telephone, lcb_site_code, is_bonded, pending.

The same object also comes as JSON text in content, for hosts that read only that.

Errors

A refusal — a wine that is not on Cru, a price out of range — comes back as a result with isError: true and a message worded for the assistant to act on. A connection without meta:read is not offered this tool, and calling it anyway returns 403 with a JSON-RPC error naming the scope. Missing or invalid credentials return 401. Conventions every tool shares →

UP NEXT Suggest 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).