Spec

Code snippets

curl "https://api.oanor.com/colordelta-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/colordelta-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/colordelta-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/colordelta-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "name": "Color Distance API",
        "notes": "sRGB, D65 white point. CIEDE2000 implemented per Sharma et al. A Delta-E of ~1 is the just-noticeable difference. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/convert",
                "params": {
                    "hex": "a hex colour",
                    "lab": "or L,a,b",
                    "rgb": "or r,g,b"
                },
                "returns": "the colour in hex, RGB, XYZ and Lab"
            },
            {
                "path": "/v1/distance",
                "params": {
                    "a_hex": "first colour (or a_rgb / a_lab)",
                    "b_hex": "second colour (or b_rgb / b_lab)"
                },
                "returns": "Delta-E 76, 94 and 2000"
            },
            {
                "path": "/v1/nearest",
                "params": {
                    "hex": "a colour (or rgb / lab)"
                },
                "returns": "the nearest named colour by CIEDE2000"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "CIE colour science as an API: convert colours through the device-independent spaces and measure how different two colours really look. The convert endpoint takes a colour as hex, RGB or CIELAB and returns it in sRGB hex, RGB, CIE XYZ and CIELAB (D65 white point). The distance endpoint computes the perceptual difference between two colours with all three standard Delta-E formulas — CIE76 (plain Lab distance), CIE94, and CIEDE2000 (the modern, most accurate metric) — and tells you whether the difference is perceptible. The nearest endpoint finds the closest named colour to any colour by CIEDE2000. This is the maths behind colour matching, print and brand-colour QC, and tolerancing — distinct from simple hex/RGB/HSL conversion. Everything is computed locally and deterministically, so it is instant and private. Ideal for print and prepress, brand-colour compliance, textile and paint matching, image processing, and design tooling. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 4 endpoints. This is CIE colour difference; for hex/RGB/HSL/CMYK conversion, palettes and WCAG contrast use a colour API."
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:11.159Z",
        "request_id": "9ad17f32-ea60-41eb-be50-b13a26812037"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}