API
Endpoints

API Endpoints

The Trycolors API provides several endpoints for color mixing and matching. Below is a detailed description of each endpoint.

Mix Colors

Mixes provided colors and returns the resulting color.

  • URL: /v1/mix-colors
  • Method: POST

Request Body

{
  "colors": [
    {
      "hex": "#FFAA16",
      "count": 1,
      "tintingStrength": 65
    },
    {
      "hex": "#BA12FF",
      "count": 1,
      "tintingStrength": 80
    }
  ],
  "mixerMode": "basic",
  "tintingStrengthMode": "uniform",
  "tintingStrengthAlgorithm": "basic"
}

Response

{
  "mixedColor": "#DD5E8B"
}

Get Similar Paints

Fetches paints similar to the given hex code.

  • URL: /v1/similar-paints
  • Method: POST

Request Body

{
  "hex": "#FF0C13",
  "count": 10,
  "brandIds": [1],
  "seriesIds": [3]
}

Response

{
  "paints": [
    {
      "hex": "#FF0C13",
      "paintName": "Red Orange 203-F",
      "sku": "203-F",
      "brandName": "1 Shot",
      "brandId": 1,
      "seriesName": "Fluorescent",
      "distance": 0
    },
    // ... more similar paints
  ]
}

Unmix Color

Reverse-engineers a target color into its constituent colors.

  • URL: /v1/unmix-color
  • Method: POST

Request Body

{
  "colors": ["#00FFFF", "#FF00FF", "#FFFF00"],
  "targetHex": "#99FF66",
  "maxColorsCount": 3,
  "maxDropsCount": 15,
  "mixerMode": "basic",
  "tintingStrengthMode": "uniform",
  "tintingStrengthAlgorithm": "neuralNetwork"
}

Response

{
  "structure": [
    {
      "hex": "#00FFFF",
      "count": 2
    },
    {
      "hex": "#FF00FF",
      "count": 0
    },
    {
      "hex": "#FFFF00",
      "count": 3
    }
  ],
  "mixedColor": "#99FF66",
  "matchResult": 100
}

For more details on request parameters and response structures, please refer to our API Reference (opens in a new tab) or contact our support team.

AuthenticationRate Limits