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

# The Color API

> Color information and scheme generation API that converts between formats (hex, RGB, HSL, CMYK), names colors, and generates harmonious color schemes.

Color information and scheme generation API that converts between formats (hex, RGB, HSL, CMYK), names colors, and generates harmonious color schemes. Best for design tool workflows that need programmatic color manipulation or palette generation. A free, no-auth utility with no rate limits.

2 example endpoints available through Lava's AI Gateway. See the [The Color API API docs](https://www.thecolorapi.com/docs) for full documentation.

<Info>This provider is **managed** — no additional setup required.</Info>

<Info>This is a **catch-all provider** — any valid URL under `https://www.thecolorapi.com` is supported. Color lookup and scheme generation. Construct URL as [https://www.thecolorapi.com/\&#123;endpoint\&#125;?\&#123;params\&#125](https://www.thecolorapi.com/\&#123;endpoint\&#125;?\&#123;params\&#125);. See [https://www.thecolorapi.com/docs](https://www.thecolorapi.com/docs) for all endpoints. The endpoints below are curated examples.</Info>

## Endpoints

### Get color information by hex value

**GET** `https://www.thecolorapi.com/id?hex=0047AB` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://www.thecolorapi.com/id?hex=0047AB', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fwww.thecolorapi.com%2Fid%3Fhex%3D0047AB" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Generate a color scheme

**GET** `https://www.thecolorapi.com/scheme?hex=0047AB&mode=analogic&count=5` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://www.thecolorapi.com/scheme?hex=0047AB&mode=analogic&count=5', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fwww.thecolorapi.com%2Fscheme%3Fhex%3D0047AB%26mode%3Danalogic%26count%3D5" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>