Now offer period OUR API HAS BEEN EXPANDED

New API V3.0: Get our API at a special price. Get it now. Get more detailed color conversion results - perfect for web projects, plugins, internal tools or SaaS applications. Valid from 2025-10-21 up to and including 2025-11-21 (23:59 CET)

API packages & prices X

V3.0 New – qConv.com Related Colors - API Documentation

With the qConv Related Color API, you can get matching colors from your source color - including RGB, HEX, CMYK, PANTONE®, RAL, HKS, NCS and custom manufacturer palettes.
IMPORTANT: For manufacturers or color palettes such as RAL, Pantone, etc., the closest matching palette color is always returned.

🔑 Authentication

The qConv API uses API keys, which you can manage via your profile.

Auth via URL parameter

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[YOUR_API-KEY]

Note: The key is Base64URL-encoded (URL-compatible) and secure.

🔗 End point

GET https://qconv.com/api/v3.0/color.php

📥 Request parameters

Parameters Type Required Description
from string ✅ Yes Source format of the color, e.g. rgb, ral or manufacturer names such as behr
input string ✅ Yes Input value, e.g. FF0000
apikey string ✅ Yes Your personal and secret API key

Supported formats

Color formats

rgb hex cmyk pantone ral hks ncs sw

Manufacturer colors

All manufacturer codes that you can find on the manufacturer pages under the following link are valid values.

https://qconv.com/en/manufactures

Look for the API code reference or this symbol in the left-hand column on the manufacturer's website:

✅ Example request

Hex

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[YOUR_API-KEY]

Answer:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "hex",
    "input": "ffa500",
    "related": {
        "comp": {
            "rgb": "0 255 255",
            "hex": "#00FFFF",
            "cmyk": "100 0 0 0",
            "hsl": "180 1 0.5",
            "lab": "91.12 -48.08 -14.14"
        },
        "dark": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "rgb": "255 0 136",
                "hex": "#FF0088",
                "cmyk": "0 100 47 0",
                "hsl": "328 1 0.5",
                "lab": "55.11 85.15 -0.4"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "rgb": "172 0 0",
                "hex": "#AC0000",
                "cmyk": "0 100 100 33",
                "hsl": "0 1 0.34",
                "lab": "35.54 59.64 49.89"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            }
        ],
        "sat_less": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ]
    },
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 1,
        "max_tokens": 50,
        "percentage_used": "2 %"
    }
}

Manufacturer color BEHR

GET /api/v3.0/color.php?from=behr&input=p120-7 glitterati&apikey=[YOUR_API-KEY]

Answer:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "behr",
    "input": "p120-7 glitterati",
    "related": {
        "comp": {
            "manufacturer": "Behr",
            "name": "mq6-41 farmer´s market",
            "rgb": "113 184 151",
            "hex": "#71B897",
            "cmyk": "39 0 18 28",
            "hsl": "152.11 0.33 0.58",
            "lab": "69.49 -29.81 9.81"
        },
        "dark": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "mfg": "Behr",
                "name": "ppu1-16 haitian flower",
                "rgb": "151 73 90",
                "hex": "#97495A",
                "cmyk": "0 52 40 41",
                "hsl": "346.92 0.35 0.44",
                "lab": "41.35 34.47 5.42"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "mfg": "Behr",
                "name": "p110-7 xoxo",
                "rgb": "145 80 123",
                "hex": "#91507B",
                "cmyk": "0 45 15 43",
                "hsl": "320.31 0.29 0.44",
                "lab": "43.04 33.27 -12.51"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "mfg": "Behr",
                "name": "bxc-21 chicory root",
                "rgb": "95 66 63",
                "hex": "#5F423F",
                "cmyk": "0 31 34 63",
                "hsl": "5.63 0.2 0.31",
                "lab": "31.09 12.12 6.83"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_less": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ]
    },
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 2,
        "max_tokens": 50,
        "percentage_used": "4 %"
    }
}

📦 Response structure

Field Type Description
api_version string Returns the currently used version of the API, e.g. 'v2'
timestamp string Timestamp of the request in ISO 8601 format, e.g. '2025-08-14T13:42:00+01:00'
http_response_code string HTTP status code of the response (e.g. 200, 400, 500). Indicates whether the request was successful or returned an error
from string Transmitted output format
input string Transmitted original value
related object The related field contains the associated shades that are calculated from the transferred color. These include complementary colors, lighter and darker variants as well as color harmonies such as triad or tetrad. For more information: Related in detail.
user_data object Information about your API account, such as the number of conversions used.
error string If an error occurs: Object with further details such as error code, description, etc. If the request is successful, this field is zero or not present

Related in detail

Color type Type Description
comp object The complementary color, i.e. the opposite color on the color wheel.
dark array A gradation of up to five darker variants of the original color.
light array A gradation of up to five lighter variants of the color.
ana array Up to five color nuances that are directly adjacent to each other on the color wheel.
mono array Up to five monochrome variations of the same basic color with different brightnesses or saturations.
warm array Up to five warmer variants of the color - tones that are slightly shifted towards red or yellow.
cold array Up to five colder variants of the color - shades that are more bluish or violet.
sat_more array Up to five colors with increased color saturation (stronger, more intense effect).
sat_less array Up to five colors with reduced saturation (more subdued, more restrained effect).
split array Three colors from the split complementary scheme - two tones that are next to the complementary color.
triad array Triadic color scheme - three colors evenly distributed on the color wheel.
tetrad array Tetradic color scheme - four colors that form a rectangle on the color wheel.
square array Square color scheme - four colors equally spaced on the color wheel.

Each object contains the following values

Color values Type Description
mfg string / null Name of the paint manufacturer, if available (e.g. Behr, OBI, RAL).
name string / null Official color designation of the manufacturer, if available.
rgb string RGB values, separated by spaces (e.g. '113 184 151').
hex string Hexadecimal color code (e.g. '#71B897').
cmyk string CMYK representation (percentage values for print or design applications).
hsl string Hue, saturation and lightness (Hue, Saturation, Lightness).
lab string Values in CIELAB color space, suitable for precise color comparisons and color analysis.

⚠️ Error codes

Status code Meaning
400 Missing or invalid parameter
401 Invalid or missing API key
429 Monthly API limit reached
500 Internal server error

If the API key is missing or an incorrect API key has been entered:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 401,
    "error": "Unauthorized",

}

If an entry is missing or a non-compliant value is entered:

{
    "api_version" => "v3.0",    
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 400,
    "error": "Missing input or from" | "Conversion failed or input invalid",
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 50,
        "max_tokens": 50,
        "percentage_used": "100 %"
    }
}

📈 API limits & billing

Each API key has a monthly limit. Free are 50 tokens per month per API key. Up to two API-KEYs can be created free of charge.

This can be extended by upgrades:
With the Basic-API tariff you can create 5 API-KEYs with 200 tokens each (∑ 1.000 tokens).
With the Premium API plan, you can create 10 API-KEYs with 1.000 tokens (∑ 10,000 tokens).
With the Voyager API tariff, you can create 50 API-KEYs with 10,000 tokens each (∑ 500,000 tokens).
If you have special requirements, we can also prepare user-specific offers at any time. Please feel free to contact us.

When the limit is reached:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 429,
    "error": "Hello USER #12345, your monthly API quota of 50 requests has been used up. Please contact [email protected] to upgrade or wait for the next reset.",
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 50,
        "max_tokens": 50,
        "percentage_used": "100 %"
    }
}

🛠️ API Manager

Manage API keys (add/delete)

View total and API-related usage

Increase limits per month through upgrades

Generate new keys (Base64URL-safe)

Add comments for better differentiation

🔒 Security

All parameters are sent via GET

Rate limiting per key optional

32 byte long Base64URL key

🧼 Notes for developers

All parameters are case-insensitive

Hex code is not possible with #: Only FF0000 are valid

255,0,0 or 255 0 0 for RGB

185C and 185 C work for PANTONE

Support

Note: For technical reasons, it may happen that no results are displayed for some manufacturer names. If you need help or your conversion does not work for any other reason not mentioned, please contact us at info[at]qconv.com. We offer support for customers from the 'Basic API Service'.

🆕 Changelog

API-V3.0:

  • NEW: There is the possibility to get the respective related colors such as complementary, lighter, darker, warmer, colder, etc. for transmitted colors. We have created /api/color.php for this purpose.
  • LAB and HSL color integrated in the answer
  • In the object user_data we have standardized the identifier 'used tokens' with an underscore.
    NEW: 'used_tokens'
  • In the object user_data we have standardized the identifier 'max tokens' with an underscore.
    NEW: 'max_tokens'
  • In the object user_data, we have standardized the identifier 'percentage used' with an underscore.
    NEW: 'percentage_used'

2025-10-21

API-V2.0:

  • Color differences are now also output as a color difference value in dE00 format (Delta E 2000) when converting to the manufacturer
  • If there is a color designation (Sherwin Williams, NCS (German), HEX or RGB), this is output
  • API version number and timestamp are also output
  • In the event of an incorrect entry, more detailed information about the reason is provided

2025-08-14

API-V1.0:

  • API integrated into the website

2025-07-15

To be able to save color palettes, a registration is required.

Log in to your account

or

Create an account

Current color palette Share
Should it be public or private?
Link(s) will follow after sharing.

Cancel Share

Color palette shared
Please copy and save the desired link.

Share

OK, I have copied the links

Your colors will be saved in a new color palette.
View them under your profile.
You can customize them further, and share them.

Show color palette
Close

Create a color palette

DownloadDownload in different formats

Remove All

By clicking on you can create palettes and download the color swatches.