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

# Get Brand Kit

> Retrieve a brand kit's colors, fonts and logos

# Get Brand Kit

Retrieve one of your brand kits: its colors, font families and logo links. Get its ID from [List Brand Kits](https://docs.submagic.co/api-reference/list-brand-kits.md).

> [!NOTE]
>
> This endpoint requires authentication and has a rate limit of 1000 requests
> per hour. It does not use API credits.

## Authentication

**x-api-key** `string` *required*

Your Submagic API key starting with `sk-`

## Path Parameters

**id** `string` *required*

The unique identifier (UUID) of the brand kit

## Response

**id** `string`

Unique identifier for the brand kit (UUID format)

**name** `string`

Brand kit name

**isDefault** `boolean`

Whether new projects use this kit by default

**colors** `array`

The kit's colors, newest first (up to 100)

**Color Object**

**name** `string`

Color name

**hex** `string`

Color value as saved, e.g. `#FF3366`

**fonts** `array`

The kit's font families, each listed once with the weights the kit has

**Font Object**

**family** `string`

Font family name

**weights** `number[]`

The weights saved for this family, in ascending order (e.g. `[400, 700]`)

**logos** `array`

The kit's logos, newest first (up to 50)

**Logo Object**

**name** `string`

Logo name

**url** `string`

Link to the logo file

**width** `number`

Logo width in pixels

**height** `number`

Logo height in pixels

```bash cURL theme={null}
curl -X GET "https://api.submagic.co/v1/brand-kits/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "x-api-key: sk-your-api-key-here"
```

```javascript JavaScript theme={null}
const getBrandKit = async (brandKitId) => {
  const response = await fetch(
    `https://api.submagic.co/v1/brand-kits/${brandKitId}`,
    {
      headers: {
        "x-api-key": "sk-your-api-key-here",
      },
    }
  );

  return response.json();
};

const brandKit = await getBrandKit("7c9e6679-7425-40de-944b-e07fc1f90ae7");
```

```python Python theme={null}
import requests

def get_brand_kit(brand_kit_id):
    url = f'https://api.submagic.co/v1/brand-kits/{brand_kit_id}'
    headers = {
        'x-api-key': 'sk-your-api-key-here'
    }

    response = requests.get(url, headers=headers)
    return response.json()

brand_kit = get_brand_kit('7c9e6679-7425-40de-944b-e07fc1f90ae7')
```

```json 200 OK theme={null}
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "Acme",
  "isDefault": true,
  "colors": [
    { "name": "Primary", "hex": "#FF3366" },
    { "name": "Ink", "hex": "#111111" }
  ],
  "fonts": [
    { "family": "Montserrat", "weights": [400, 700] },
    { "family": "Inter", "weights": [400] }
  ],
  "logos": [
    {
      "name": "Wordmark",
      "url": "https://cdn.example.com/logo.png",
      "width": 640,
      "height": 160
    }
  ]
}
```

```json 404 NOT_FOUND theme={null}
{
  "error": "NOT_FOUND",
  "message": "Brand kit not found"
}
```

```json 400 VALIDATION_ERROR - Invalid ID theme={null}
{
  "error": "VALIDATION_ERROR",
  "message": "id must be a valid UUID"
}
```

> [!NOTE]
>
> A brand kit that does not exist, belongs to another account, or is on a plan
> without brand kits returns `404`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.