API v3 — SmartCut API Reference
Version 3.1.0
Cutting optimisation for sheet, linear and roll stock.
Send a list of parts and the stock you have; get back an optimised cutting layout. Supports guillotine cutting for panel saws and true-shape nesting for CNC, honouring grain direction, edge banding, blade kerf and per-edge trim. Results export to PDF, CSV, DXF, SVG and saw formats including PTX, Biesse XML and Mayer.
Calculations are asynchronous: submit to /v3/calculate, then poll /v3/result/ready and collect from /v3/result. Authentication is your API key in the Authorization header, with no Bearer prefix.
Beta surfaces: parts[].labels + top-level labels.customer — typed saw label-printer fields. PTX-only today; Biesse XML and Mayer .MAY to follow. Schema may change; see /v3/export/ptx for the current PTX column mapping.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v3/calculate | Submit calculation |
| POST | /v3/validate | Validate inputs without calculating |
| POST | /v3/model/analysis | Analyse a 3D model into parts |
| GET | /v3/result/ready | Check if calculation is complete |
| GET | /v3/result | Retrieve calculation result |
| GET | /v3/export/pdf | Export result as PDF |
| GET | /v3/export/csv | Export result as CSV |
| GET | /v3/export/ptx | Export result as PTX (beam saw format) |
| GET | /v3/export/dxf | Export result as DXF |
| GET | /v3/export/svg | Export result as SVG |
| GET | /v3/export/mayer | Export result as Mayer .may (Beta) |
| GET | /v3/export/biesse | Export result as Biesse XML CutList (Beta) |
| GET | /v3/saws | List saws + export formats offered |
| GET | /v3/spec | Optimisation spec — selectable models + saws + their gating |
| POST | /v3/labels | Generate printable part labels |
| POST | /webhooks/result | Calculation result delivery |
| GET | /v3/calls | Get API usage statistics |
Machine-readable specification:
/openapi/v3.json.
Authentication is the raw API key in the Authorization header,
with no Bearer prefix.