---
title: "List Brand Kits"
method: GET
path: "/brand-kits"
tags: ["brand-kits"]
---

# List Brand Kits

`GET /brand-kits`

List brand kits for the team (cursor-paginated, newest first).

## Query parameters

- `cursor` string, nullable — Opaque pagination cursor. Pass the ``next_cursor`` from the previous response. Omit on the first request.
- `limit` integer — Max brand kits per page. Defaults to 20, caps at 100.

## Headers

- `Moda-Version` '2026-04-12' | '2026-05-01'

## Response `200`

Successful Response

- ListBrandKitsResponse — Cursor-paginated brand-kits list response (ENG-2377). ``team_id`` is no longer included in the canonical response — it's implicit in the API key's team context. Callers who need the team id can read it once off their own key's metadata.
  - `data` BrandKitItem[], required — Brand kits in this page, newest first.
    - `id` string, required — Unique brand kit identifier (prefixed ``bk_...``).
    - `title` string, required — Display name of the brand kit.
    - `is_default` boolean, required — Whether this is the default brand kit for the team.
    - `created_at` string, nullable — ISO 8601 timestamp when the brand kit was created.
    - `updated_at` string, nullable — ISO 8601 timestamp of the last modification.
    - `company_name` string, nullable — Company name associated with this brand kit.
    - `company_url` string, nullable — Company website URL.
    - `company_description` string, nullable — Brief description of the company.
    - `default_theme_canvas_id` string, nullable — Prefixed ``cvs_`` wire ID (Crockford base32 body) — the canonical, recommended form. For back-compat, **a bare UUID string is also accepted** in both path parameters and JSON request bodies (older integrations that stored raw UUIDs keep working). Both are permanent, supported inputs.
  - `next_cursor` string, nullable — Opaque cursor for the next page; ``null`` when the end of the list is reached.

## Other responses

- `401` — Authentication required.
- `403` — Permission denied for this scope.
- `404` — Resource not found.
- `409` — Conflict (idempotency / resource state).
- `422` — Request validation failed.
- `429` — Rate limit exceeded.
- `500` — Internal error.

---

[API](https://skmtc.dev/moda/apis/moda-public-api.md) · [All operations](https://skmtc.dev/moda/apis/moda-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moda/moda-public-api/revisions/b34cb4cca59e/schema)