API Overview

The Trycolors API mixes paint colors, reverse-engineers a target color into a recipe from paints you name, and searches the Trycolors paint catalog.

Getting Started

Sign up for an account at trycolors.com/signin (opens in a new tab).
Generate your API key in your account settings (opens in a new tab).
Send the key in the X-API-KEY header on every request.

Base URL

https://api.trycolors.com/v1

Available Endpoints

Endpoint	Method	What it does
`/unmix-color`	POST	Turns a target color into a recipe from the paints you send
`/mix-colors`	POST	Mixes paints in given proportions and returns the result
`/paints/search`	POST	Searches the paint catalog by keyword, color and filters
`/similar-paints`	POST	Finds catalog paints close to a hex code

Any other path under /v1/ is not part of the public API. See Endpoints for request and response details.

Example: Mixing Colors

const response = await fetch('https://api.trycolors.com/v1/mix-colors', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': process.env.TRYCOLORS_API_KEY
  },
  body: JSON.stringify({
    colors: [
      { hex: '#FFAA16', count: 1 },
      { hex: '#BA12FF', count: 1 }
    ],
    mixerMode: 'basic'
  })
});
 
const data = await response.json();
console.log(data.mixedColor); // "#DD5E8B"

Responses carry no engine version and no request id. Store the settings you sent alongside any recipe you keep, so you can reproduce it later.

Next Steps

For questions or feedback, contact our support team (opens in a new tab).

Advanced Authentication