---
title: "List Documents Route"
method: GET
path: "/api/v2/knowledge/documents"
tags: ["knowledge"]
---

# List Documents Route

`GET /api/v2/knowledge/documents`

Paginated document listing.

## Query parameters

- `app_id` string
- `project_id` string
- `category_id` string, nullable
- `page` integer
- `page_size` integer
- `sort_by` 'created_at' | 'updated_at' | 'title'
- `sort_order` 'asc' | 'desc'

## Response `200`

Successful Response

- SuccessEnvelopeDocumentListResponse
  - `request_id` string, required
  - `data` DocumentListResponse, required — Response for GET /documents.
    - `documents` DocumentOverviewItemDTO[], required
      - `doc_id` string, required
      - `category_id` string, required
      - `title` string, required
      - `topic_count` integer, required
      - `created_at` string, date-time, required
    - `total` integer, required
    - `page` integer, required
    - `page_size` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-24** `305b14a16dcd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/evermind-ai/apis/everos/changes/api/v2/knowledge/documents/get.md)

---

[API](https://skmtc.dev/evermind-ai/apis/everos.md) · [All operations](https://skmtc.dev/evermind-ai/apis/everos/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evermind-ai/everos/revisions/9a2e78d664d6/schema)
