id: Get color identification

API: thecolorapi.com:the-color-api
Endpoint: /id
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 200
Latency: 451ms

Description

Returns identifying information for a given color including name, conversions to multiple formats, images, and contrast information.

Parameters (8)

callback (string, query, optional)

JSONP callback function name

cmyk (string, query, optional)

Valid CMYK color (e.g., 100,58,0,33)

format (string, query, optional, default: json)

Return format

Constraints: {'enum': ['json', 'html', 'svg']}

hex (string, query, optional)

Valid hex code without # (e.g., 0047AB)

Constraints: {'pattern': '^[0-9A-Fa-f]{6}$'}

hsl (string, query, optional)

Valid HSL color (e.g., 215,100%,34% or hsl(215,100%,34%))

named (boolean, query, optional, default: True)

Whether to print color names on image (SVG only)

rgb (string, query, optional)

Valid RGB color (e.g., 0,71,171 or rgb(0,71,171))

w (integer, query, optional, default: 100)

Width of resulting image (SVG format only)

Examples (2)

Get color identification openapi-spec 
curl 'https://www.thecolorapi.com/id?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33'
import requests

resp = requests.get(
    "https://www.thecolorapi.com/id",
    params={
        'hex': '0047AB',
        'rgb': '0,71,171',
        'hsl': '215,100%,34%',
        'cmyk': '100,58,0,33',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("thecolorapi")
result = api.fetch("id", hex="0047AB", rgb="0,71,171", hsl="215,100%,34%", cmyk="100,58,0,33")

for item in result:
    print(item)
const resp = await fetch("https://www.thecolorapi.com/id?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33");
const data = await resp.json();
Get color identification probe-gate 
curl 'https://www.thecolorapi.com/id?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33&format=json&w=100&named=True'
import requests

resp = requests.get(
    "https://www.thecolorapi.com/id",
    params={
        'hex': '0047AB',
        'rgb': '0,71,171',
        'hsl': '215,100%,34%',
        'cmyk': '100,58,0,33',
        'format': 'json',
        'w': '100',
        'named': 'True',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("thecolorapi")
result = api.fetch("id", hex="0047AB", rgb="0,71,171", hsl="215,100%,34%", cmyk="100,58,0,33", format="json", w=100, named="True")

for item in result:
    print(item)
const resp = await fetch("https://www.thecolorapi.com/id?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33&format=json&w=100&named=True");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 16:48:18.798909 200 451ms
2026-04-16 02:29:01.275965 200 472ms
2026-04-16 01:40:53.244457 200 452ms
2026-04-15 03:46:28.029854 200 421ms
2026-04-15 01:28:22.830512 200 477ms
2026-04-14 02:33:08.440550 200 472ms
2026-04-14 00:10:09.800088 200 3210ms
2026-04-12 14:39:03.199238 200 450ms
2026-04-12 12:59:06.136788 200 420ms
2026-04-10 01:45:45.572441 200 354ms
2026-04-10 01:41:23.098158 200 406ms
2026-04-09 02:09:33.263234 200 572ms
2026-04-09 01:21:31.674479 200 478ms
2026-03-28T07:35:52.138233 200 407ms