API v2 — SmartCut API Reference
Version 2
A modern, performant cut cutlist optimization API.
V2 Features: Separate saw configuration object Dual side naming support (x1/x2/y1/y2 or l1/l2/w1/w2) Hybrid banding support (top-level or extras structure) Webhook support for async results Custom data fields Enhanced metadata with material summaries
Backward Compatibility: V2 accepts both legacy and modern formats.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v2/calculate | Kick off the calculations |
| GET | /result/ready | Check if the calculation has finished |
| GET | /result | Retrieve the calculation result |
| GET | /export | Export result in various formats |
| POST | /labels | Generate printable part labels |
| GET | /calls | Get API usage statistics |
Machine-readable specification:
/openapi/v2.json.
Authentication is the raw API key in the Authorization header,
with no Bearer prefix.