# List brands

`GET https://api.cream-ai.de/api/v1/brands`

Brands of the company with their linked styles and voices (no asset URLs). Sorted by `name`, then `id`. Changes made in mint may take up to 30 seconds to appear.

Scopes: `catalog:read`

## Parameters

- `limit` (query): Page size (1–100).
- `cursor` (query): Opaque cursor from next_cursor of the previous page.

## Returns

- 200: One page of the list.

## Errors

- 400: Invalid request (invalid_request, invalid_json, invalid_cursor, idempotency_key_required, invalid_idempotency_key, parent_not_found, max_depth_exceeded, narration_too_long, user_not_in_company, template_not_found, category_not_found, feedback_kind_unsupported, upload_not_found).
- 401: Missing, malformed, revoked or expired API key (unauthorized).
- 403: Not allowed (forbidden_scope, ip_not_allowed, company_inactive, api_not_enabled).
- 429: Too many requests (rate_limited).
- 500: Internal error (internal). Quote the request id when you contact support.
- 503: Temporarily unavailable (service_unavailable). Retry later (after Retry-After seconds, if sent).

## Example request

```sh
curl "https://api.cream-ai.de/api/v1/brands" \
  -H "Authorization: Bearer $MINT_API_KEY"
```

## Example response (200)

```json
{
  "object": "list",
  "data": [
    {
      "object": "brand",
      "id": "brand-northwind-x7k2p9",
      "slug": "northwind",
      "name": "Northwind University",
      "description": "Corporate design for all course films.",
      "status": "active",
      "style_ids": [
        "b6ed57e1-2c4f-4b8a-9d3e-6f1a0c2b7e45"
      ],
      "voices": [
        {
          "voice_id": "Xb7hH8MSUJpSbSDYk0k2",
          "name": "Clara",
          "language": "de",
          "default": true
        }
      ],
      "created_at": "2026-09-14T10:02:44Z",
      "updated_at": "2026-10-21T12:52:17Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}
```