---
title: "List files for an entity"
method: GET
path: "/api/v1/ackdb/entities/{entityId}/files"
tags: ["ackDB"]
---

# List files for an entity

`GET /api/v1/ackdb/entities/{entityId}/files`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/entities/{entityId}/files`
- Auth: HTTP bearer

List files (images, PDFs, documents) attached to an entity. Supports filtering by source, MIME type, and processing status.

## Path parameters

- `entityId` string, required

## Query parameters

- `source` string
- `fileType` string
- `processed` boolean
- `limit` integer
- `offset` integer

## Response `200`

List of files with metadata.

- object
  - `data` AckdbFileMetadata[]
    - `id` string: ULID
    - `entityId` string
    - `eventId` string, nullable
    - `source` string
    - `fileName` string
    - `fileType` string: MIME type
    - `fileSizeBytes` integer
    - `sourceFileId` string, nullable
    - `sourceUrl` string, nullable
    - `metadata` object
    - `description` string, nullable: AI-generated description (after processing)
    - `processed` boolean: Whether the file has been processed for embeddings
    - `createdAt` string, date-time
  - `pagination` AckdbPagination
    - `total` integer
    - `limit` integer
    - `offset` integer

---

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