Get Colors

GET /api/v1/colors/{niche}

Returns the color catalog for a specific niche. If your API key has custom colors configured, those will be returned instead of the default catalog.

Path parameters

string

required

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