# List approved styles

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

Approved editorial styles the company can use for films: its own styles, styles shared with it and global styles, each in its approved revision. Sorted by `updated_at` (newest first), 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).
- 404: Not found (not_found).
- 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/styles" \
  -H "Authorization: Bearer $MINT_API_KEY"
```

## Example response (200)

```json
{
  "object": "list",
  "data": [
    {
      "object": "style",
      "id": "b6ed57e1-2c4f-4b8a-9d3e-6f1a0c2b7e45",
      "slug": "lecture-clean",
      "name": "Lecture – clean",
      "visibility": "organization",
      "access": "own",
      "approved_revision": 4,
      "approved_at": "2026-10-29T09:45:12Z",
      "updated_at": "2026-10-29T09:45:12Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}
```