# SmartCut API Documentation

URL: https://smartcut.dev/docs

> Cloud-based cutting-optimization platform — REST API, embeddable calculator, hosted e-commerce, WordPress plugin and embedded diagrams.

SmartCut is a cloud platform for **material cutting optimization**. Send it a list of parts and stock and it returns efficient cutting layouts for sheet, linear and roll materials — with kerf, grain, trim, edge-banding, machining and saw constraints all handled server-side by the same optimisation engine that powers [Cutlist Evolution](https://cutlistevo.com).

You can consume it however suits your product:

- **REST API** — submit a calculation, poll for the result, and export to PDF, DXF, SVG, CSV, labels and machine formats (PTX, Biesse, Mayer …). Async processing, multiple algorithms, full metadata.
- **Embedded JavaScript calculator** — drop a cut-to-size pricing/quoting widget straight into your own checkout.
- **Embedded diagram** — show an interactive cutting layout on any page with a single `<iframe>`.
- **Hosted e-commerce** — a complete cut-to-size storefront (Stripe payments, stock, orders) with no development.
- **WordPress / WooCommerce plugin** — the same cut-to-size selling experience inside WordPress.

## Explore the docs

- **[API Reference](/docs/api)** — endpoints, request/response schema and authentication.
- **[Guide](/docs/guide)** — concepts, terminology and how to model your cutting jobs.
- **[MCP server](/docs/mcp)** — run optimisations from Claude, Cursor or your own LLM client.
- **[Updates](/docs/updates)** — the REST API changelog.
- **[Hosted store](/docs/ecommerce)** — analytics, webhooks and order-management APIs for the hosted storefront.
- **[Checkout API](/docs/ecommerce-checkout)** — the client-side embedded calculator/checkout.
- **[Store config MCP](/docs/ecommerce-mcp)** — configure your storefront from an LLM client.
- **[Embedded diagram](/docs/embed)** — iframe parameters, colours and messaging.
- **[WordPress plugin](/docs/wordpress-plugin)** — installation and configuration.

## Interactive API reference

Browse and try every endpoint live:

- [**API v3**](/api-docs/v3) — current
- [API v2](/api-docs/v2) · [API v1](/api-docs/v1) — maintained / deprecated
- [E-commerce API](/api-docs/ecommerce)

## Get started

1. **[Create an account](https://smartcut.dev/account)** and grab your API key.
2. Read the **[Guide](/docs/guide)** to model your stock, parts and saw.
3. Make your first call against the **[v3 reference](/api-docs/v3)** — submit a calculation, then fetch the result.
4. **[Export](/docs/api)** the layout to your preferred format, or embed the diagram/calculator on your site.

Need a hand? Use the live chat on [smartcut.dev](https://smartcut.dev) or get in touch via the [contact page](https://smartcut.dev/contact.html).