The Partner Trading API v1 is in beta — endpoints and response shapes may still change.
Choose how to authenticate your requests.
For Production · United States · USD — change these in the toolbar.
Use a credential without an IP allowlist: calls reach Cru from this site’s server.
Cru issues partners a CLIENT-KEY and CLIENT-SECRET, sent as headers on every request. There is no token to fetch first. Writes run at once and carry a reference the playground generates.
CLIENT-KEY
CLIENT-SECRET
reference
No credentials yet? Request API access
Credentials are kept for this session only, never included in copied examples, and redacted from everything the playground shows.
Build a request, over REST or MCP, and inspect the response.
Production environment · Write requests require confirmation
list_for_sale
Prepares a new offer, of the stock_type given. Documentation ↗
tools/call · list_for_sale
https://us.cruworldwine.com/api/mcp
Carried out straight away, with no confirmation step. Sending the same reference again returns the first result, so each send gets a new one. You will be asked to confirm before it is sent.
stock_type
What is listed: "cru" (wine stored with Cru), "external" (wine the customer holds outside Cru) or "supplier" (a supplier's own stock).
portfolio_id
Cru only, and needed for it: the portfolio line to list, from get_my_portfolio, one that is not listed yet.
lwin18
External and supplier only, and needed for them: the wine, from search_wines.
quantity
How many units to list.
price
Price per unit in the market currency, e.g. 30780 or 30780.50: for cru and external, the asking price the buyer pays; for supplier, what the supplier receives.
warehouse_code
External only, and needed for it: the Cru warehouse the wine is sold through, one list_warehouses marks sells_your_inbond_wine.
condition_status
The wine's condition. For external, omit for the level Cru has set for the customer, which is also the most it can be. For supplier, omit for verified, or apd when duty_paid.
condition_text
Supplier only: what buyers are told about the condition, needed for apd (duty-paid stock says "Duty Paid in the UK" unless given); not for verified.
duty_paid
Supplier only: true when the duty has been paid, which makes it apd. Omit for in bond.
cost
External only, optional: what the customer paid per unit, in the market currency.
inbond_address_id
External only, optional: the inbond warehouse the wine is in now, from list_inbond_warehouses. Omit if the customer is not sure.
Your own unique reference for this instruction.
Nothing sent yet. The response appears here.
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.
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.
We use what you send here to reply about API access, and for nothing else. Cloudflare Turnstile checks the form for bots (privacy policy).
