{"openapi":"3.1.0","info":{"title":"Color Name API","version":"1.0.0","description":"Name any colour. The nearest endpoint takes a colour as a hex, an rgb() value, an r,g,b triple or another name and returns the closest of the 140+ CSS named colours — matched perceptually with CIE76 Lab distance, not naive RGB, so the name actually looks right — along with the distance and whether it is an exact match. The name endpoint resolves a CSS colour keyword (e.g. rebeccapurple, cornflowerblue) to its hex and RGB, and list returns the whole named-colour set. Perfect for design tools and pickers, accessibility and theming, turning brand hex codes into human labels, and naming colours in generated palettes. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 4 endpoints. Distinct from colour conversion / palette / contrast tooling, which does not name colours.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/colorname-api","description":"oanor gateway"}],"tags":[{"name":"Color Name"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/name":{"get":{"operationId":"get_v1_name","tags":["Color Name"],"summary":"Look up a colour name","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"A CSS colour name","schema":{"type":"string"},"example":"rebeccapurple"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hex":"#663399","rgb":[102,51,153],"name":"rebeccapurple"},"meta":{"timestamp":"2026-06-03T01:09:43.540Z","request_id":"68945c51-cb10-4796-a923-741207efce69"},"status":"ok","message":"Look up a colour name","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/nearest":{"get":{"operationId":"get_v1_nearest","tags":["Color Name"],"summary":"Nearest named colour","description":"","parameters":[{"name":"color","in":"query","required":true,"description":"hex, rgb(), r,g,b or a name","schema":{"type":"string"},"example":"#6597ed"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"exact":false,"input":{"hex":"#6597ed","rgb":[101,151,237]},"nearest":{"hex":"#6495ed","rgb":[100,149,237],"name":"cornflowerblue"},"distance":1.476},"meta":{"timestamp":"2026-06-03T01:09:43.621Z","request_id":"c6912607-23ff-479e-b125-4131202358e9"},"status":"ok","message":"Nearest named colour","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Reference"],"summary":"List named colours","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":148,"colors":[{"hex":"#f0f8ff","rgb":[240,248,255],"name":"aliceblue"},{"hex":"#faebd7","rgb":[250,235,215],"name":"antiquewhite"},{"hex":"#00ffff","rgb":[0,255,255],"name":"aqua"},{"hex":"#7fffd4","rgb":[127,255,212],"name":"aquamarine"},{"hex":"#f0ffff","rgb":[240,255,255],"name":"azure"},{"hex":"#f5f5dc","rgb":[245,245,220],"name":"beige"},{"hex":"#ffe4c4","rgb":[255,228,196],"name":"bisque"},{"hex":"#000000","rgb":[0,0,0],"name":"black"},{"hex":"#ffebcd","rgb":[255,235,205],"name":"blanchedalmond"},{"hex":"#0000ff","rgb":[0,0,255],"name":"blue"},{"hex":"#8a2be2","rgb":[138,43,226],"name":"blueviolet"},{"hex":"#a52a2a","rgb":[165,42,42],"name":"brown"},{"hex":"#deb887","rgb":[222,184,135],"name":"burlywood"},{"hex":"#5f9ea0","rgb":[95,158,160],"name":"cadetblue"},{"hex":"#7fff00","rgb":[127,255,0],"name":"chartreuse"},{"hex":"#d2691e","rgb":[210,105,30],"name":"chocolate"},{"hex":"#ff7f50","rgb":[255,127,80],"name":"coral"},{"hex":"#6495ed","rgb":[100,149,237],"name":"cornflowerblue"},{"hex":"#fff8dc","rgb":[255,248,220],"name":"cornsilk"},{"hex":"#dc143c","rgb":[220,20,60],"name":"crimson"},{"hex":"#00ffff","rgb":[0,255,255],"name":"cyan"},{"hex":"#00008b","rgb":[0,0,139],"name":"darkblue"},{"hex":"#008b8b","rgb":[0,139,139],"name":"darkcyan"},{"hex":"#b8860b","rgb":[184,134,11],"name":"darkgoldenrod"},{"hex":"#a9a9a9","rgb":[169,169,169],"name":"darkgray"},{"hex":"#006400","rgb":[0,100,0],"name":"darkgreen"},{"hex":"#a9a9a9","rgb":[169,169,169],"name":"darkgrey"},{"hex":"#bdb76b","rgb":[189,183,107],"name":"darkkhaki"},{"hex":"#8b008b","rgb":[139,0,139],"name":"darkmagenta"},{"hex":"#556b2f","rgb":[85,107,47],"name":"darkolivegreen"},{"hex":"#ff8c00","rgb":[255,140,0],"name":"darkorange"},{"hex":"#9932cc","rgb":[153,50,204],"name":"darkorchid"},{"hex":"#8b0000","rgb":[139,0,0],"name":"darkred"},{"hex":"#e9967a","rgb":[233,150,122],"name":"darksalmon"},{"hex":"#8fbc8f","rgb":[143,188,143],"name":"darkseagreen"},{"hex":"#483d8b","rgb":[72,61,139],"name":"darkslateblue"},{"hex":"#2f4f4f","rgb":[47,79,79],"name":"darkslategray"},{"hex":"#2f4f4f","rgb":[47,79,79],"name":"darkslategrey"},{"hex":"#00ced1","rgb":[0,206,209],"name":"darkturquoise"},{"hex":"#9400d3","rgb":[148,0,211],"name":"darkviolet"},{"hex":"#ff1493","rgb":[255,20,147],"name":"deeppink"},{"hex":"#00bfff","rgb":[0,191,255],"name":"deepskyblue"},{"hex":"#696969","rgb":[105,105,105],"name":"dimgray"},{"hex":"#696969","rgb":[105,105,105],"name":"dimgrey"},{"hex":"#1e90ff","rgb":[30,144,255],"name":"dodgerblue"},{"hex":"#b22222","rgb":[178,34,34],"name":"firebrick"},{"hex":"#fffaf0","rgb":[255,250,240],"name":"floralwhite"},{"hex":"#228b22","rgb":[34,139,34],"name":"forestgreen"},{"hex":"#ff00ff","rgb":[255,0,255],"name":"fuchsia"},{"hex":"#dcdcdc","rgb":[220,220,220],"name":"gainsboro"},{"hex":"#f8f8ff","rgb":[248,248,255],"name":"ghostwhite"},{"hex":"#ffd700","rgb":[255,215,0],"name":"gold"},{"hex":"#daa520","rgb":[218,165,32],"name":"goldenrod"},{"hex":"#808080","rgb":[128,128,128],"name":"gray"},{"hex":"#008000","rgb":[0,128,0],"name":"green"},{"hex":"#adff2f","rgb":[173,255,47],"name":"greenyellow"},{"hex":"#808080","rgb":[128,128,128],"name":"grey"},{"hex":"#f0fff0","rgb":[240,255,240],"name":"honeydew"},{"hex":"#ff69b4","rgb":[255,105,180],"name":"hotpink"},{"hex":"#cd5c5c","rgb":[205,92,92],"name":"indianred"},{"hex":"#4b0082","rgb":[75,0,130],"name":"indigo"},{"hex":"#fffff0","rgb":[255,255,240],"name":"ivory"},{"hex":"#f0e68c","rgb":[240,230,140],"name":"khaki"},{"hex":"#e6e6fa","rgb":[230,230,250],"name":"lavender"},{"hex":"#fff0f5","rgb":[255,240,245],"name":"lavenderblush"},{"hex":"#7cfc00","rgb":[124,252,0],"name":"lawngreen"},{"hex":"#fffacd","rgb":[255,250,205],"name":"lemonchiffon"},{"hex":"#add8e6","rgb":[173,216,230],"name":"lightblue"},{"hex":"#f08080","rgb":[240,128,128],"name":"lightcoral"},{"hex":"#e0ffff","rgb":[224,255,255],"name":"lightcyan"},{"hex":"#fafad2","rgb":[250,250,210],"name":"lightgoldenrodyellow"},{"hex":"#d3d3d3","rgb":[211,211,211],"name":"lightgray"},{"hex":"#90ee90","rgb":[144,238,144],"name":"lightgreen"},{"hex":"#d3d3d3","rgb":[211,211,211],"name":"lightgrey"},{"hex":"#ffb6c1","rgb":[255,182,193],"name":"lightpink"},{"hex":"#ffa07a","rgb":[255,160,122],"name":"lightsalmon"},{"hex":"#20b2aa","rgb":[32,178,170],"name":"lightseagreen"},{"hex":"#87cefa","rgb":[135,206,250],"name":"lightskyblue"},{"hex":"#778899","rgb":[119,136,153],"name":"lightslategray"},{"hex":"#778899","rgb":[119,136,153],"name":"lightslategrey"},{"hex":"#b0c4de","rgb":[176,196,222],"name":"lightsteelblue"},{"hex":"#ffffe0","rgb":[255,255,224],"name":"lightyellow"},{"hex":"#00ff00","rgb":[0,255,0],"name":"lime"},{"hex":"#32cd32","rgb":[50,205,50],"name":"limegreen"},{"hex":"#faf0e6","rgb":[250,240,230],"name":"linen"},{"hex":"#ff00ff","rgb":[255,0,255],"name":"magenta"},{"hex":"#800000","rgb":[128,0,0],"name":"maroon"},{"hex":"#66cdaa","rgb":[102,205,170],"name":"mediumaquamarine"},{"hex":"#0000cd","rgb":[0,0,205],"name":"mediumblue"},{"hex":"#ba55d3","rgb":[186,85,211],"name":"mediumorchid"},{"hex":"#9370db","rgb":[147,112,219],"name":"mediumpurple"},{"hex":"#3cb371","rgb":[60,179,113],"name":"mediumseagreen"},{"hex":"#7b68ee","rgb":[123,104,238],"name":"mediumslateblue"},{"hex":"#00fa9a","rgb":[0,250,154],"name":"mediumspringgreen"},{"hex":"#48d1cc","rgb":[72,209,204],"name":"mediumturquoise"},{"hex":"#c71585","rgb":[199,21,133],"name":"mediumvioletred"},{"hex":"#191970","rgb":[25,25,112],"name":"midnightblue"},{"hex":"#f5fffa","rgb":[245,255,250],"name":"mintcream"},{"hex":"#ffe4e1","rgb":[255,228,225],"name":"mistyrose"},{"hex":"#ffe4b5","rgb":[255,228,181],"name":"moccasin"},{"hex":"#ffdead","rgb":[255,222,173],"name":"navajowhite"},{"hex":"#000080","rgb":[0,0,128],"name":"navy"},{"hex":"#fdf5e6","rgb":[253,245,230],"name":"oldlace"},{"hex":"#808000","rgb":[128,128,0],"name":"olive"},{"hex":"#6b8e23","rgb":[107,142,35],"name":"olivedrab"},{"hex":"#ffa500","rgb":[255,165,0],"name":"orange"},{"hex":"#ff4500","rgb":[255,69,0],"name":"orangered"},{"hex":"#da70d6","rgb":[218,112,214],"name":"orchid"},{"hex":"#eee8aa","rgb":[238,232,170],"name":"palegoldenrod"},{"hex":"#98fb98","rgb":[152,251,152],"name":"palegreen"},{"hex":"#afeeee","rgb":[175,238,238],"name":"paleturquoise"},{"hex":"#db7093","rgb":[219,112,147],"name":"palevioletred"},{"hex":"#ffefd5","rgb":[255,239,213],"name":"papayawhip"},{"hex":"#ffdab9","rgb":[255,218,185],"name":"peachpuff"},{"hex":"#cd853f","rgb":[205,133,63],"name":"peru"},{"hex":"#ffc0cb","rgb":[255,192,203],"name":"pink"},{"hex":"#dda0dd","rgb":[221,160,221],"name":"plum"},{"hex":"#b0e0e6","rgb":[176,224,230],"name":"powderblue"},{"hex":"#800080","rgb":[128,0,128],"name":"purple"},{"hex":"#663399","rgb":[102,51,153],"name":"rebeccapurple"},{"hex":"#ff0000","rgb":[255,0,0],"name":"red"},{"hex":"#bc8f8f","rgb":[188,143,143],"name":"rosybrown"},{"hex":"#4169e1","rgb":[65,105,225],"name":"royalblue"},{"hex":"#8b4513","rgb":[139,69,19],"name":"saddlebrown"},{"hex":"#fa8072","rgb":[250,128,114],"name":"salmon"},{"hex":"#f4a460","rgb":[244,164,96],"name":"sandybrown"},{"hex":"#2e8b57","rgb":[46,139,87],"name":"seagreen"},{"hex":"#fff5ee","rgb":[255,245,238],"name":"seashell"},{"hex":"#a0522d","rgb":[160,82,45],"name":"sienna"},{"hex":"#c0c0c0","rgb":[192,192,192],"name":"silver"},{"hex":"#87ceeb","rgb":[135,206,235],"name":"skyblue"},{"hex":"#6a5acd","rgb":[106,90,205],"name":"slateblue"},{"hex":"#708090","rgb":[112,128,144],"name":"slategray"},{"hex":"#708090","rgb":[112,128,144],"name":"slategrey"},{"hex":"#fffafa","rgb":[255,250,250],"name":"snow"},{"hex":"#00ff7f","rgb":[0,255,127],"name":"springgreen"},{"hex":"#4682b4","rgb":[70,130,180],"name":"steelblue"},{"hex":"#d2b48c","rgb":[210,180,140],"name":"tan"},{"hex":"#008080","rgb":[0,128,128],"name":"teal"},{"hex":"#d8bfd8","rgb":[216,191,216],"name":"thistle"},{"hex":"#ff6347","rgb":[255,99,71],"name":"tomato"},{"hex":"#40e0d0","rgb":[64,224,208],"name":"turquoise"},{"hex":"#ee82ee","rgb":[238,130,238],"name":"violet"},{"hex":"#f5deb3","rgb":[245,222,179],"name":"wheat"},{"hex":"#ffffff","rgb":[255,255,255],"name":"white"},{"hex":"#f5f5f5","rgb":[245,245,245],"name":"whitesmoke"},{"hex":"#ffff00","rgb":[255,255,0],"name":"yellow"},{"hex":"#9acd32","rgb":[154,205,50],"name":"yellowgreen"}]},"meta":{"timestamp":"2026-06-03T01:09:43.713Z","request_id":"83b11a00-a217-4ea2-b49e-2ef9f0ddac47"},"status":"ok","message":"List named colours","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Color Name API","notes":"Uses the CSS Color Module Level 4 named-colour set. Distance is perceptual (Lab); 0 means an exact match. Nothing is stored.","version":"v1","endpoints":[{"path":"/v1/nearest","params":{"color":"hex, rgb(), r,g,b or a name (required)"},"returns":"the closest named colour, distance and whether it is exact"},{"path":"/v1/name","params":{"name":"a CSS colour name (required)"},"returns":"its hex and RGB"},{"path":"/v1/list","params":[],"returns":"all named colours"},{"path":"/v1/meta","params":[],"returns":"this document"}],"description":"Find the nearest named CSS colour to any colour (perceptually, using CIE76 Lab distance), look up a CSS colour name to its hex/RGB, and list all 140+ named colours. Pure local, no key."},"meta":{"timestamp":"2026-06-03T01:09:43.811Z","request_id":"ad97512e-9463-409d-972e-b6b0a9390ac9"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1005,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":45,"monthly_call_quota":8450,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2035,"monthly_call_quota":135500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5835,"monthly_call_quota":715000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/colorname-api"}