---
title: "List moments in a moments collection"
method: GET
path: "/collections/{collection_id}/moments"
tags: ["Collections"]
---

# List moments in a moments collection

`GET /collections/{collection_id}/moments`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/collections/{collection_id}/moments`
- Auth: HTTP bearer

Moments across current collection members, with exact total. Default sort is positional (file_id, then start_time); criterion_score and rank_score sorts require a single-criterion filter. Removing a file from the collection drops its moments from this enumeration; the underlying runs persist.

## Path parameters

- `collection_id` string, uuid, required

## Query parameters

- `criterion_name` string
- `attachment_id` string, uuid
- `file_id` string, uuid
- `min_score` number
- `sort` 'position' | 'criterion_score' | 'rank_score'
- `limit` integer
- `cursor` string

## Response `200`

Moments across current collection members, with exact total.

- CollectionMomentsList
  - `moments` object[], required
    - `moment_id` string, uuid, required
    - `start_time` number, required: Seconds from source start.
    - `end_time` number, required
    - `anchors` object: Declared anchors only; an anchor that was not found is absent, never null.
    - `title` string, required
    - `reason` string, required
    - `speakers` string[]
    - `criterion_score` CriterionScore: The rubric's judgment on its own declared scale.
      - `key` string, required
      - `value` number, required
      - `min` number, required
      - `max` number, required
    - `rank_score` number, required: Normalized ordering within the run; what the default sort uses.
    - `properties` object: Validates against the criterion's moment_schema.
    - `evidence` object
      - `signals` string[]
    - `file_id` string, uuid, required
    - `job_id` string, uuid, required
    - `criterion_name` string, required
  - `total` integer, required: Exact total across current members.
  - `next_cursor` string

## Other responses

- `400`: Not a moments collection, or a score sort without a single-criterion filter
- `404`: Collection not found
- `500`: Internal server error

## Changes

- **2026-10-30** `23d3f240819f`: 3 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `500` status
- **2026-08-22** `d2a5205fc779`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/collections/:collection_id/moments/get.md)

---

[API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [All operations](https://skmtc.dev/cloudglue/apis/cloudglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudglue/apis/cloudglue-api/revisions/23d3f240819f?raw)