Appearance

API Updates ​

Latest updates and changes to the SmartCut REST API.

NOV
28
2025
  • Added custom data properties to stock & parts.
  • Added stock.stack to checkout API V3
  • Updated v3/export/ and documentation
NOV
3
2025
  • API V3 launched, V1 marked as deprecated.
JAN
31
2025
  • For V1 API users, the stockList and partList properties have been removed from the response. Please use the stock and parts properties instead.
DEC
17
2024
  • In the PTX file, when no edge banding is present in a part, a blank field will be used rather than the string 'N' - this was causing issues when importing into Magi-Cut.
NOV
9
2024
  • Added 'stackingMode' to saw options, which determines how stock will be stacked.
NOV
4
2024
  • Use of the 'bandingType' property within each part has been deprecated. Please use the 'banding' attribute instead, which can now accept a boolean or a string value.
  • New 'finish' attribute added to parts. This can be used to specify the finish of a part, for example spray paint. Metadata now includes totalFinishArea and finishAreaByType properties to show the total area of parts with a finish applied split by finish type. Each stock also contains a finishArea property within 'analysis'.
FEB
19
2024
  • Experimental feature userGroups has been updated. Now uses id and 'direction' rather than id and coordinates. This is a breaking change and will require updates to your code if you were using this feature.
FEB
5
2024
  • Roll length in metadata is now total roll length - the key is now 'totalRollLength'
  • Stacked cut length and total cuts is now available in metadata and stock analysis
  • Beam saw calculations now need a stack height to be set
DEC
11
2023
  • Better handling of exports & label files - the file url is now returned in the response body.
  • Files in zip format have new filenames - please use the response url.
  • Added rollLength to the metadata object in the response.
OCT
25
2023
  • Revamp to guillotine and efficiency algorithms.
  • Guillotine now supports a second phase of optimization to allow left over parts to be squeezed into offcut positions.
  • More information now contained in 'metadata' in the API response.
  • Version 2 of the WooCommerce plugin released - greatly improved setup experience and more pricing models.
JUL
2
2023
  • Added new options to the saw object to allow further customisation of the cutting process
JUN
13
2023
  • Unusable parts are now returned in the results with an explanation of why they couldn't be used
APR
1
2023

Version 2 released

  • New schema - please read the updated documentation
  • Added the concept of a saw - no need to add blade width & cut preference to each stock individually
  • For object based data (for example trim) if no values are set, the object will be replaced with null
  • Smaller data payload for faster results
  • 20% quicker response times
  • Version 1 will continue to be supported
FEB
1
2023
  • Added linear offcuts to api result
JAN
20
2023
  • Added labels endpoint - create printable labels to keep track of parts and offcuts
JAN
12
2023
  • Added grain direction to stock and offcuts
  • Added name & thickness to offcuts
NOV
1
2022
  • Metered billing now available - no need to worry about setting limits for your plan.
AUG
3
2022
  • Updated algorithm for both efficiency & guillotine calculations.
JUL
13
2022
  • Launched checkout widget to easily integrate into your e-commerce store.
JUL
5
2022
  • Improved status responses:
  • 403 for reaching the monthly call limit
  • 429 for exceeding the allowed calls per minute
OCT
4
2022
  • Added the 'bandingType' attribute to parts
  • In the results, the length of each banding type is returned in the 'metadata' object
JUL
3
2022
  • Major infrastructure upgrade for better reliability, more capacity and more processing power.
  • The original three-tiered plans are now retired. These are treated as legacy plans which will continue to work. Migration to the new monthly plan is recommended.
  • All plans are now based on your requirements and billed monthly. This allows much more fine-grained control over every option.
  • New configurable values include the number of calls per minute.
  • The 'autoAdd' option for stock can now be used for multiple stock items. Previously this was only allowed with a single stock item.