> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pixcraft.es/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /colors/:niche

> Get the available color catalog for a specific niche.

# 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

<ParamField path="niche" type="string" required>
  Niche ID (e.g., `curtains`, `mosaics`, `lego`)
</ParamField>

## Example request

```bash theme={null}
curl https://www.pixcraft.es/api/v1/colors/curtains \
  -H "Authorization: Bearer px_live_your_key"
```

## Example response

```json theme={null}
{
  "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](https://pixcraft.es/dashboard/api).

## Common errors

| Code            | Description                                        |
| --------------- | -------------------------------------------------- |
| `INVALID_NICHE` | The niche ID does not exist or is not on your plan |