---
title: "List all extracted entities for files in a collection"
method: GET
path: "/collections/{collection_id}/entities"
tags: ["Collections"]
---

# List all extracted entities for files in a collection

`GET /collections/{collection_id}/entities`

## Request

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

List all extracted entities for files in a collection. This API is only available when a collection is created with collection_type 'entities'

## Path parameters

- `collection_id` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `order` 'added_at' | 'filename'
- `sort` 'asc' | 'desc'
- `added_before` string, date
- `added_after` string, date

## Response `200`

A list of file entities in the collection

- CollectionEntitiesList
  - `object` 'list', required: Object type, always 'list'
  - `data` object[], required: Array of file entities
    - `file_id` string, required: ID of the file
    - `data` object, required
      - `entities` object, required: Entities extracted from the file at the video level
      - `segment_entities` object[]: Array of video entities extracted from individual time segments
        - `start_time` number: Start time of the segment in seconds
        - `end_time` number: End time of the segment in seconds
        - `entities` object: Entities extracted from the segment
  - `total` integer, required: Total number of files with entities matching the query
  - `limit` integer, required: Number of items returned in this response
  - `offset` integer, required: Offset from the start of the list

## Other responses

- `400`: Collection type is not 'entities'
- `404`: Collection not found
- `500`: An unexpected error occurred on the server

## 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-03-11** `1d5d6115c0d0`: 4 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
  - for the `query` request parameter `order`, default value `added_at` was removed
  - for the `query` request parameter `sort`, default value `desc` was removed

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/collections/:collection_id/entities/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)