Beta

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

Developers
Cru World Wine

Configure connection

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.

How authentication works

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.

Partner credentials →

No credentials yet?

Credentials are kept for this session only, never included in copied examples, and redacted from everything the playground shows.

API playground

Build a request, over REST or MCP, and inspect the response.

Tool reference
Partner key

Production environment · Write requests require confirmation

Request

What the customer has sold on Cru, one entry per unit sold, stored with Cru or held outside it, by the date it sold (traded_at), newest first unless direction is "asc", as the Cru app's Sold list shows it, in the market currency: price is the list's Sold For (for wine held outside Cru, after Cru's commission), cru_id, transfer_ref (the transfer's reference, when there is one), cost (what the customer paid), sold_price (what the sale came to before Cru's commission and any fee), Cru's commission (commission_percent and commission; none for a supplier), any settlement_fee, net_proceeds (what the customer received: sold_price less commission and settlement_fee), profit_loss (net_proceeds less cost) and profit_loss_percent (of cost; null when no cost is recorded), and for wine held outside Cru the Cru warehouse it goes to (deliver_to, deliverable_warehouse_code) and when it is due there (deliver_by), all null for wine that was not. Documentation ↗

POSTtools/call · list_my_sales

https://us.cruworldwine.com/api/mcp

Arguments

Only sales of these wines, as 18-digit LWIN18 codes (wine, vintage and pack). Get them from search_wines.

Only sales in these states - see status.

Only sales of wine held outside Cru going to any of these Cru warehouses - see list_warehouses.

What to order sales by: traded_at, the date of the sale.

"desc" (newest first, the default) or "asc" (oldest first).

Sales per page.

Sales to skip, for the next page.

Response

Nothing sent yet. The response appears here.

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).