---
title: "List documents for the current tenant (paginated)."
method: GET
path: "/v1/documents"
tags: ["documents"]
---

# List documents for the current tenant (paginated).

`GET /v1/documents`

## Request

- Base URL: `https://api.andish.ru` (the document declares no server; this is the origin it was published from)
- URL: `https://api.andish.ru/v1/documents`
- Auth: none declared

Returns a paginated list of documents for the authenticated workspace.

**Sorting:** Use ``sort=last_queried_at`` with ``order=asc`` (NULLs first, then oldest) or ``order=desc`` to sort by last citation timestamp.

**Filtering by activity (Feature 03-bis):**
- ``filter=never_queried`` — documents with ``last_queried_at IS NULL``
- ``filter=quiet_90d`` — not cited in 90+ days (or never)
- ``filter=quiet_30d`` — not cited in 30+ days (or never)
- ``filter=active`` — cited within the last 30 days

XL part rows are always hidden (ADR-037 §2.8).

## Query parameters

- `limit` integer
- `offset` integer
- `sort` 'created_at' | 'last_queried_at', nullable: Sort field. Default: created_at.
- `order` 'asc' | 'desc', nullable: Sort direction. Default: desc for created_at, asc for last_queried_at.
- `filter` 'never_queried' | 'quiet_90d' | 'quiet_30d' | 'active', nullable: Activity filter. never_queried=never cited; quiet_90d=not cited in 90+ days; quiet_30d=not cited in 30+ days; active=cited within 30 days.

## Response `200`

Successful Response

- DocumentListResponse: Paginated list of documents for the current tenant.
  - `items` DocumentResponse[], required
    - `document_id` string, required
    - `status` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `meta` object, required
    - `progress_percent` integer, required
    - `error_message` string, nullable
    - `processed_at` string, date-time, nullable
    - `content` string, nullable
    - `deletion_impact` DeletionImpactResponse: Serialisable snapshot of DeletionImpact (E7.2 / E7.3). Field names use the short JSON keys mandated by ADR-011 §Decision: ``chunks``, ``edges``, ``entities_exclusive``, ``entities_shared``, ``vectors`` — no ``_count`` suffix in the wire format.
      - `chunks` integer, required
      - `edges` integer, required
      - `entities_exclusive` integer, required
      - `entities_shared` integer, required
      - `vectors` integer, required
    - `is_parent` boolean
    - `document_date` string, nullable
    - `last_queried_at` string, date-time, nullable
    - `content_summary` string, nullable
    - `chunks_count` integer, nullable
    - `entity_count` integer, nullable
    - `edge_count` integer, nullable
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `queue_depth` integer, nullable
  - `estimated_wait_seconds` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/andish/apis/mnemo-api.md) · [All operations](https://skmtc.dev/andish/apis/mnemo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/andish/apis/mnemo-api/revisions/d5449f23414c?raw)