# List the comments on a film

`GET https://api.cream-ai.de/api/v1/films/{id}/comments`

The comments on a finished film: by default on its latest finished revision, with `revision` on an earlier one. Sorted by `at_s`, then `id`. Comments come from the API and from users in mint; `author` tells who wrote them (personal data). Paging: pass `revision` together with `cursor`; if a newer revision was finished in between, a cursor without `revision` returns `400 invalid_cursor`. `409 film_not_ready` if the film has no finished revision yet; an unknown `revision` returns `404 not_found`.

Scopes: `feedback:write`

## Parameters

- `id` (path, required): Id of the film (id from POST /films or GET /films).
- `revision` (query): Revision of the film (default: the latest finished one).
- `limit` (query): Page size (1–100).
- `cursor` (query): Opaque cursor from next_cursor of the previous page.

## Returns

- 200: One page of comments (limit 1–100).

## 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).
- 409: The film has no finished revision yet (film_not_ready).
- 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/films/k7m2xq9v4t8n1b5r3c6d0wza/comments" \
  -H "Authorization: Bearer $MINT_API_KEY"
```

## Example response (200)

```json
{
  "object": "list",
  "revision": 2,
  "data": [
    {
      "object": "comment",
      "id": "cmt_9QwX2rLm7Tz",
      "revision": 2,
      "at_s": 42.5,
      "x": 0.62,
      "y": 0.31,
      "scene": 5,
      "message": "The chart should show 2026, not 2025.",
      "author": {
        "kind": "api",
        "name": "Learning platform",
        "email": null
      },
      "status": "open",
      "result": null,
      "attachments": [
        {
          "upload_id": "upl_3f9a1c7e5b2d4a6c8e0f1a3b5c7d9e1f",
          "media_id": "md_77120"
        }
      ],
      "created_at": "2026-11-11T15:02:19Z",
      "updated_at": "2026-11-11T15:02:19Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}
```