# Get Colors

> Learn how to retrieve saved brand colors from your workspace

- **URL**: https://orshot.com/docs/api-reference/brand-colors-get

---

## Overview

This endpoint allows you to retrieve a list of saved brand colors from your workspace. Brand colors can be used across your templates and designs for consistent branding.```markdown tab="Endpoint"
https://api.orshot.com/v1/brand-assets/colors/get
```## Query Parameters

| Parameter | Type   | Required | Description                                                                                      |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------ |
| `tag`     | String | No       | Comma-separated list of tags to filter by. Returns only colors that have **all** specified tags. |

## Request

<Tabs items=>
<Tab value="Request">```js
await fetch("https://api.orshot.com/v1/brand-assets/colors/get", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>
<Tab value="Filter by Tags">```js
await fetch("https://api.orshot.com/v1/brand-assets/colors/get?tag=primary,brand", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>
<Tab value="Response">```json
{
  "data": [
    {
      "id": 123,
      "created_at": "2025-09-10T15:30:45.123Z",
      "type": "hex",
      "value": "#FF5733",
      "tags": ["primary", "brand"],
      "workspace_id": 50,
      "user_id": "abcdef01-2345-6789-abcd-ef0123456789"
    },
    {
      "id": 124,
      "created_at": "2025-09-10T14:20:30.456Z",
      "type": "gradient",
      "value": "linear-gradient(135deg, #667eea 0%, #764ba2 100%)",
      "tags": ["brand"],
      "workspace_id": 50,
      "user_id": "abcdef01-2345-6789-abcd-ef0123456789"
    }
  ]
}
```</Tab>
</Tabs>

## Rate Limits

- 30 requests per minute per endpoint

## Response Fields

| Field          | Type     | Description                                           |
| -------------- | -------- | ----------------------------------------------------- |
| `id`           | Number   | Unique identifier for the color                       |
| `created_at`   | String   | Timestamp when the color was saved                    |
| `type`         | String   | Color type: `hex`, `rgb`, `hsl`, or `gradient`        |
| `value`        | String   | The color value (e.g., `#FF5733`, `rgb(255, 87, 51)`) |
| `tags`         | String[] | Tags associated with the color                        |
| `workspace_id` | Number   | ID of the workspace the color belongs to              |
| `user_id`      | String   | ID of the user who saved the color                    |