---
title: "List Documents"
method: GET
path: "/v1/documents"
---

# List Documents

`GET /v1/documents`

List organization-visible documents from native or custom sources.

Includes documents from custom sources, chat uploads, and mailbox attachments.
Requires the **Export** permission (`read` scope). Private documents owned by
individual users are excluded. Results use cursor-based pagination.

## Query parameters

- `sourceId` string, nullable
- `name` string, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ListDocumentsResponse
  - `documents` DocumentListItem[], required
    - `id` string, required
    - `displayName` string, required
    - `sourceId` string, required
    - `remoteId` string, required
    - `url` string, nullable
    - `contentType` string, required
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
  - `pagination` PaginationInfo, required — Cursor-based pagination metadata returned alongside list responses. All public-API list endpoints emit the same shape: pass ``next_cursor`` back as the ``cursor`` query parameter to fetch the next page; check ``has_more`` to know whether more pages exist.
    - `nextCursor` string, nullable
    - `hasMore` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sybill/apis/sybill-api.md) · [All operations](https://skmtc.net/sybill/apis/sybill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sybill/sybill-api/revisions/f499ec011b17/schema)