Free Color Converter API - HEX, RGB & HSL

Parameters

name	in	type	required	description
`color`	query	string	required	HEX, RGB, or HSL format
`format`	query	string	optional	Auto-detected if empty one of `hexrgbhsl`

Request

Send your key in the X-API-Key header. More languages and patterns live on the code examples page.

curl -s "https://apixies.io/api/v1/convert-color?color=%233B82F6" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch("https://apixies.io/api/v1/convert-color?color=%233B82F6", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

$ch = curl_init("https://apixies.io/api/v1/convert-color?color=%233B82F6");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: YOUR_API_KEY"],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($data);

import requests

res = requests.get(
    "https://apixies.io/api/v1/convert-color",
    params={"color": "#3B82F6"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(res.json())

Response

The result sits under data in the standard envelope. See the response format guide for errors and status codes.

returns

data.hex: The color as a hex code, like #ff5733.
data.rgb: Red, green and blue values, also as rgb_string.
data.hsl: Hue, saturation and lightness, also as hsl_string.
data.input_format: Format detected in your input: hex, rgb or hsl.

example response 200

{
    "status": "success",
    "http_code": 200,
    "code": "SUCCESS",
    "message": "Color converted successfully",
    "data": {
        "input": "#3B82F6",
        "input_format": "hex",
        "hex": "#3b82f6",
        "rgb": {
            "r": 59,
            "g": 130,
            "b": 246
        },
        "rgb_string": "rgb(59, 130, 246)",
        "hsl": {
            "h": 217,
            "s": 91,
            "l": 60
        },
        "hsl_string": "hsl(217, 91%, 60%)",
        "converted_at": "2026-09-18T12:00:00+00:00"
    }
}

Authentication and limits

This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.

Standard rate limits apply to this endpoint.

Common use cases

Design tool integration

Convert colors between HEX, RGB, and HSL formats in design automation tools. Bridge the gap between different design system formats.

Theme generator

Build color palette generators that convert a single color across all formats. Create consistent theme files for CSS, SCSS, or design tokens.

Accessibility contrast checking

Convert colors to RGB values for WCAG contrast ratio calculations. Ensure your color combinations meet accessibility standards.

related endpoints

GET Timestamp Converter Convert between Unix timestamps and human-readable date formats POST Base64 Encode/Decode Encode or decode Base64 strings GET QR Code Generator Generate an SVG QR code image from any text or URL

getting started

authentication code examples response format

explore

all api endpoints guides and tutorials online tools

resources

homepage changelog suggest an endpoint

Get a free API key

A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.

get a temporary key create an account