# List documents

Lists documents filtered by one or more kind names, with optional field projection and cursor-based pagination.

Request:
kinds             - List of Kind names to filter by.
fetches           - Optional field projection expression limiting which document fields are returned.
includeDeleted   - When true, includes soft-deleted documents in the results.
pagination        - Optional Pagination cursor and page size.

Response:
documents     - List of Document objects matching the filter.
pageCursor   - Opaque cursor for the next page. Absent when there are no further results.

Endpoint: POST /api/v1/document/list
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `kinds` (array)

  - `fetches` (string)
    Rule data fields

  - `includeDeleted` (boolean)

  - `pagination` (any)

## Response 200 fields (application/json):

  - `documents` (array)

  - `documents.id` (string)
    Rule data fields

  - `documents.kind` (string)
    Rule data fields

  - `documents.doc` (any)

  - `documents.createdDt` (object)

  - `documents.createdDt.seconds` (integer)

  - `documents.createdDt.nanos` (integer)

  - `documents.updatedDt` (object)

  - `documents.deletedDt` (object)

  - `pageCursor` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)