> ## 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.

# List Brand Kits

> List the brand kits in your account

# List Brand Kits

Retrieve the brand kits saved in your Submagic account. Brand kits are made in the Submagic app and hold your brand's colors, fonts and logos. For a team member, these are the team owner's brand kits.

The kit new projects use by default comes first, then the others, newest first. The list returns at most 50 kits.

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

> [!NOTE]
>
> Brand kits are part of some Submagic plans. If your plan does not include
> them, the list is empty.

## Authentication

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

Your Submagic API key starting with `sk-`

## Response

**data** `array`

Your brand kits

**Brand Kit Object**

**id** `string`

Unique identifier for the brand kit (UUID format). Use it with [Get Brand
Kit](https://docs.submagic.co/api-reference/get-brand-kit.md), or as `brandKitId` when you [start an
Iris edit](https://docs.submagic.co/api-reference/iris-create-project.md).

**name** `string`

Brand kit name

**isDefault** `boolean`

Whether new projects use this kit by default

```bash cURL theme={null}
curl -X GET "https://api.submagic.co/v1/brand-kits" \
  -H "x-api-key: sk-your-api-key-here"
```

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

  return response.json();
};

const { data: brandKits } = await listBrandKits();
```

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

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

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

brand_kits = list_brand_kits()['data']
```

```json 200 OK theme={null}
{
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Acme",
      "isDefault": true
    },
    {
      "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "name": "Acme Podcast",
      "isDefault": false
    }
  ]
}
```

```json 200 OK (no brand kits) theme={null}
{
  "data": []
}
```

```json 401 UNAUTHORIZED theme={null}
{
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key"
}
```


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