Skip to content

API Reference

The SmartCut API provides server-to-server cutting optimization capabilities for your applications.

API Versions

Choose the version that best suits your needs:

V3 - Latest Current

The most recent version with the latest features and optimizations.

View V3 Documentation →

V2 - Stable Stable

Mature and well-tested version, recommended for production use.

View V2 Documentation →

V1 - Legacy Legacy

Original version, maintained for backward compatibility only.

View V1 Documentation →

Quick Start

Authentication

All API requests require an API key. Include it in the Authorization header:

javascript
const response = await fetch('https://api.smartcut.dev/calculate', {
  method: 'POST',
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    // Your request data
  })
})

Basic Example

javascript
const response = await fetch('https://api.smartcut.dev/v3/calculate', {
  method: 'POST',
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    stock: [
      { l: 2440, w: 1220, t: 18 }
    ],
    parts: [
      { l: 600, w: 400, t: 18, q: 10 }
    ],
    saw: {
      bladeWidth: 3.2,
      cutPreference: 'efficiency'
    }
  })
})

const { jobId } = await response.json()
javascript
const response = await fetch('https://api.smartcut.dev/v2/calculate', {
  method: 'POST',
  headers: {
    'Authorization': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    stock: [
      { l: 2440, w: 1220, t: 18 }
    ],
    parts: [
      { l: 600, w: 400, t: 18, q: 10 }
    ],
    saw: {
      bladeWidth: 3.2,
      cutPreference: 'efficiency'
    }
  })
})

const { jobId } = await response.json()

Support