Get Colors
GET /api/v1/colors/{niche}
Path parameters
Niche ID (e.g., curtains, mosaics, lego)
Example request
curl https://www.pixcraft.es/api/v1/colors/curtains \
-H "Authorization: Bearer px_live_your_key"
Example response
{
"niche": "curtains",
"catalog": "default",
"colors": [
{
"id": "blanco",
"name": "Blanco",
"hex": "#FFFFFF",
"available": true
},
{
"id": "crema",
"name": "Crema",
"hex": "#FFFDD0",
"available": true
},
{
"id": "negro",
"name": "Negro",
"hex": "#000000",
"available": true
}
]
}
Custom color catalogs
If your API key has custom_colors configured, the catalog field will be "custom" and the colors array will contain your custom palette instead of the default one.
Configure custom colors in your API Keys dashboard.
Common errors
| Code | Description |
|---|
INVALID_NICHE | The niche ID does not exist or is not on your plan |
