Endpoint
GET https://requiems.xyz/v1/technology/color
Convert Color
Convert a color value from one format to another. The response always includes all four formats.
Parameters
| Name |
Type |
Required |
Location |
Description |
from |
string |
yes |
query |
Source color format: hex, rgb, hsl, or cmyk |
to |
string |
yes |
query |
Target color format: hex, rgb, hsl, or cmyk |
value |
string |
yes |
query |
Color value in the source format (e.g. #ff5733, rgb(255,87,51), hsl(11,100%,60%), cmyk(0%,66%,80%,0%)) |
Response Example
{
"data": {
"input": "#ff5733",
"result": "hsl(11, 100%, 60%)",
"formats": {
"hex": "#ff5733",
"rgb": "rgb(255, 87, 51)",
"hsl": "hsl(11, 100%, 60%)",
"cmyk": "cmyk(0%, 66%, 80%, 0%)"
}
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
input |
string |
The original value passed in the value parameter |
result |
string |
The color expressed in the requested to format |
formats.hex |
string |
HEX representation (#rrggbb) |
formats.rgb |
string |
RGB representation (rgb(r, g, b)) |
formats.hsl |
string |
HSL representation (hsl(h, s%, l%)) |
formats.cmyk |
string |
CMYK representation (cmyk(c%, m%, y%, k%)) |
Errors
400 bad_request — One or more of from, to, or value parameters is missing or the from/to value is not one of: hex, rgb, hsl, cmyk.422 invalid_color — The value cannot be parsed in the specified from format.500 internal_error — Unexpected server error.
1---
2name: color-conversion-get-color
3api: Color Format Conversion
4method: GET
5path: /v1/technology/color
6base_url: https://requiems.xyz
7description: Convert a color value from one format to another. The response always includes all four formats.
8---
9
10## Endpoint
11
12**GET https://requiems.xyz/v1/technology/color**
13
14## Convert Color
15
16Convert a color value from one format to another. The response always includes all four formats.
17
18## Parameters
19
20| Name | Type | Required | Location | Description |
21| ---- | ---- | -------- | -------- | ----------- |
22| `from` | string | yes | query | Source color format: hex, rgb, hsl, or cmyk |
23| `to` | string | yes | query | Target color format: hex, rgb, hsl, or cmyk |
24| `value` | string | yes | query | Color value in the source format (e.g. #ff5733, rgb(255,87,51), hsl(11,100%,60%), cmyk(0%,66%,80%,0%)) |
25
26## Response Example
27
28```json
29{
30 "data": {
31 "input": "#ff5733",
32 "result": "hsl(11, 100%, 60%)",
33 "formats": {
34 "hex": "#ff5733",
35 "rgb": "rgb(255, 87, 51)",
36 "hsl": "hsl(11, 100%, 60%)",
37 "cmyk": "cmyk(0%, 66%, 80%, 0%)"
38 }
39 },
40 "metadata": {
41 "timestamp": "2026-01-01T00:00:00Z"
42 }
43}
44```
45
46## Response Fields
47
48| Field | Type | Description |
49| ----- | ---- | ----------- |
50| `input` | string | The original value passed in the value parameter |
51| `result` | string | The color expressed in the requested to format |
52| `formats.hex` | string | HEX representation (#rrggbb) |
53| `formats.rgb` | string | RGB representation (rgb(r, g, b)) |
54| `formats.hsl` | string | HSL representation (hsl(h, s%, l%)) |
55| `formats.cmyk` | string | CMYK representation (cmyk(c%, m%, y%, k%)) |
56
57## Errors
58
59- `400` **bad_request** — One or more of from, to, or value parameters is missing or the from/to value is not one of: hex, rgb, hsl, cmyk.
60- `422` **invalid_color** — The value cannot be parsed in the specified from format.
61- `500` **internal_error** — Unexpected server error.
gabrielmoreira