Skip to main content
FOR DEVELOPERS

CutOptim Engine API

The same 2D panel and 1D linear cutting engine that powers CutOptim, callable over HTTP. Send parts and stock, get back the full layout, cut plan and yield — ready to drop into an ERP, a quoting tool, or a machine’s own software.

Why build on it

DETERMINISTIC

The same input always returns the same output — no randomness, no clock in the algorithm. You can cache results and diff them in tests.

A REAL CUT PLAN

Not just rectangles: the guillotine cut sequence, cut lines vs. saw passes, sawn length, and a flag telling you whether it is producible on a panel saw.

PANEL-SAW AWARE

Kerf, per-side trim, tolerance, cost mode, grain groups, max cutting stages, rotation minimising — the same options the app exposes.

One call, a full plan

curl https://api.cutoptim.com/v1/optimize/2d \
  -H "Authorization: Bearer co_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "parts": [
      { "name": "Door",    "w": 600, "h": 400, "qty": 4 },
      { "name": "Shelf",   "w": 800, "h": 300, "qty": 6 }
    ],
    "stock":   [{ "w": 2440, "h": 1220, "price": 42 }],
    "options": { "kerf": 3 }
  }'

Comes back as:

{
  "metrics": { "sheetCount": 1, "yieldPct": 80.62, "placed": 10, "total": 10,
               "cutLines": 13, "sawPasses": 13, "cutLength": 12080, "totalPrice": 42 },
  "sheets":  [ … ],
  "cutPlan": [{ "sheet": 0, "step": 1, "axis": "h", "pos": 800, "length": 2440, "stage": 1 }, … ],
  "guillotineValid": true,
  "engineVersion": "1.0.0+10e0c941",
  "deterministic": true
}

Full request and response shape, every option, all error codes and both engines: API reference →

Pricing

€49/month
10,000 requests / month — hard cap, no overage, no surprise bill
14-day trial · billed in EUR · once the cap is reached, calls return 402 until the month rolls over

Larger volumes. 10,000 requests a month is the standard plan, not a ceiling on what we can run. If you need more — higher volume, separate keys for staging and production, or a dedicated arrangement — tell us your numbers and we price it individually. Tell us your volume →

The regular CutOptim plans (Free / Pro / Workshop) are unrelated to the API — the in-app optimizer stays included in them. See app pricing →