# List brand kits

> GET /brand-kits

Source: https://mockflow.com/developers/reference/brand-kits/list-brand-kits

**GET** `https://api.mockflow.com/v1/brand-kits`  
Scopes: `user:read`

**curl**

```bash
curl https://api.mockflow.com/v1/brand-kits \
  -H "Authorization: Bearer $MOCKFLOW_API_KEY"
```

**JavaScript**

```javascript
const response = await fetch("https://api.mockflow.com/v1/brand-kits", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MOCKFLOW_API_KEY}`
  }
});

const data = await response.json();
```

**Python**

```python
import os, requests

response = requests.get(
    "https://api.mockflow.com/v1/brand-kits",
    headers={"Authorization": f"Bearer {os.environ['MOCKFLOW_API_KEY']}"},
)

response.raise_for_status()
data = response.json()
```

**200**

```json
{
  "nextCursor": "string",
  "hasMore": false,
  "data": [
    {
      "id": "bk_K3f9a0c1d2e4b5a6978869a0b1c2d3e4f",
      "name": "Q4 Launch Planning",
      "colors": [
        {
          "name": "Q4 Launch Planning",
          "hex": "#1c7ce2"
        }
      ],
      "headingFont": "string",
      "bodyFont": "string",
      "rules": "string"
    }
  ]
}
```

**402**

```json
{
  "error": {
    "code": "plan_limit",
    "message": "AI credits exhausted. 0 of 2000 remaining this month.",
    "upgradeUrl": "https://mockflow.com/pricing"
  },
  "requestId": "req_01ja"
}
```

**429**

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests.",
    "docsUrl": "https://mockflow.com/developers/concepts/errors#rate_limited"
  },
  "requestId": "req_45d49816999bac40"
}
```

Your team's brand kits. With `boardId`, also the kits of that board's team, when you are on the board. Kits are made and edited in the editor (AI Skills, Brand kits) by team admins. Plus and Max only.

### Authorization

- `Authorization` (string, required): `Bearer <key>`. The key needs `user:read` scope. Create and manage keys in the [developer console](/developers/console/), or use an [OAuth app](/developers/concepts/oauth-apps) to act for other people; what each scope unlocks is on the [scopes page](/developers/concepts/scopes).

### Query parameters

- `boardId` (string): A board you are on (brd_…), to include its team's kits.
- `cursor` (string): Opaque cursor from a previous response's `nextCursor`.
- `limit` (integer): Defaults to `50`.

### Response

- `nextCursor` (string | null)
- `hasMore` (boolean)
- `data` (BrandKit[]): - `id` (string)
  - `name` (string)
  - `colors` (object[]): Most important first.
  - `headingFont` (string | null)
  - `bodyFont` (string | null)
  - `rules` (string): The kit's voice and brand rules.
  - `logos` (object[])
  - `instructions` (string): The whole kit as the text Mida follows.

### Errors

- 402 `plan_limit`: The workspace plan does not allow this, or AI credits are exhausted.
- 429 `rate_limited`: Too many requests.