This site holds the Cutwise user guides, the Platform API reference, a knowledge base about diamond optics and grading, prices, release notes and contacts.

Start here

• Manage your stock: import, share access, publish to RapNet
• Connect your own systems to Cutwise with the Platform API
• Estimate the color of the diamonds a rough diamond will yield (partners)
• Learn how cut and light make a diamond look the way it does
• See what each service costs
• See what changed in Cutwise
• Contact Cutwise and its service centers

Some guides open only after you sign in with a Cutwise account. Pages marked for partners need an account that belongs to a partner company. Internal pages are for Octonus staff. A badge next to a link shows the level. If you cannot open a page, it does not appear in the lists.

Documentation

How Cutwise works: screens, services and import formats.

• Stock and Projects

  Get diamonds, rough diamonds and projects into Cutwise, and decide who may see them.

  • Stock Management

    Publish your diamonds, rough diamonds and projects to Cutwise, and control who may see them.

• Grading Services

  How Cutwise estimates the color of rough diamonds and of the diamonds planned from them, and how the color grading demo works.

  • Color Grading Demo

    Grade the color of demo diamonds against color references, and see the grades on Cutwise pages.

• Platform API

  The public REST API for managing diamonds on Cutwise from your own systems.

  • API Conventions

    How the API handles redirects, which HTTP methods it uses and how to send timestamps.

  • API Authorization

    Getting an OAuth 2.0 access token and sending it with every API request.

  • Constants API

    Dictionaries and technical constants that the other APIs refer to by id.

  • Diamonds API v4

    Managing a vendor's diamonds published on Cutwise, with grades as plain string values.

  • Diamonds API v4: Accepted Values

    The values Diamonds API v4 accepts for shape, color, clarity and the other grades.

  • Certifications API v4

    Attaching a lab certificate to a diamond and removing it.

  • Diamonds API v3

    Managing a vendor's diamonds, with grades as ids from the Constants API dictionaries.

  • Media Meta API

    Reading the DiBox and ViBox metadata of uploaded media by diamond, project or setup preset.

  • API Error Handling

    HTTP status codes the API returns and what a client should do with each.

  • Optical Performance Scores in the API

    How the API encodes Fire, Brilliance, Spread and Fluorescence scores and their scale.

  • Fancy Color Grades in the API

    The Munsell hue, value and chroma fields the API returns for a fancy colored diamond.

  • API Examples

    JavaScript examples that sign in and call Diamonds API v3 and v4.

Knowledge base

Articles about the diamond optics and grading that Cutwise measures. They are true whether or not you use Cutwise.

• Optical Performance Evaluation

  Fire, brilliance and symmetry, measured from captured video rather than judged by eye.

• Diamond Cutting Styles & Shapes

  How shape and facet pattern change what a diamond does with light.

• Ray Path in Round Diamond

  How pavilion angle moves the ray path, and what that does to a round's performance.

• Sweet Line in Round Diamonds

  The proportion combinations that keep a round bright across lighting conditions.

• Apparent Size

  Why two diamonds of the same weight look different in size, and how spread measures it.

• Added-Value Diamonds

  Why two diamonds with the same 4C grades can face up differently.

• Live Comparison in DiBox JD

  Fire and scintillation of two cuts side by side, and what size does to fire.

Pricing

What each service costs.

• DiBox 2.0

  Uploads, Optical Performance Scores, inclusion plotting, decryption and hosting for DiBox 2.0 and other media.

• ViBox 2.0

  D–Z and fancy color grading of polished diamonds, video decoding and the showcase.

• Cut Evolution

  Allocation and planning with HP Carbon projects. Upload is free; you pay per planned diamond you render.

• Conversion Services

  Converting model files from one format to another, such as OX2Z to STL, and rendering your own 3D model in the Light–Spectrum demo.

• Web Clarity Plotting

  Clarity plotting of a rough or polished diamond on its ViBox 2.0 3D model, or on a model imported from STL.

• DiLog

  A shareable report of a polished diamond, made from its Cutwise media or from an external 3D model. Priced on request.

Release notes

What changed in each version, and when.

• Cutwise 2026.6.0 13 October 2026

  Cutwise 2026.6.0 grades the color of uploaded and Cut Evolution solutions, gives fancy color diamonds a precise Cutwise grade you can search by, and shows running tasks on the product page.

• Cutwise 2026.5.0 3 September 2026

  Cutwise 2026.5.0 calculates Dead Zones for DiBox 2.0 data, adds Octonus Zone Human Vision to photo rendering and updates FCRF color grading.

• Cutwise 2026.4.0 12 August 2026

  Cutwise 2026.4.0 adds the Dead Zones metric, a unified Tasks interface with progress for every task, and a spectrum choice for Brilliant Story rendering.

All release notes

About

What Cutwise does for the diamond trade, and how to reach Cutwise and its service centers.

• Why Cutwise

  What a company gets from Cutwise as a platform: media delivery at scale, computing capacity that follows demand, control over who sees each diamond, and open integration.

Contacts and service centers