---
title: "List your saved documents (the Files view)."
method: GET
path: "/v1/documents"
tags: ["v1", "mcp"]
---

# List your saved documents (the Files view).

`GET /v1/documents`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/documents`
- Auth: HTTP bearer

List the authenticated user/org's saved documents, most-recently-updated first
(metadata only — no document content). Each carries a session_count ("N chats"). Documents
become durable + reusable automatically as you create or edit them; on the FIRST call we also
one-time import the documents of pre-Files-view chats so prior work appears here too.
Pass archived=true to browse the soft-deleted set (the Files "Archived" filter).

## Query parameters

- `limit` integer: Maximum number of documents to return.
- `offset` integer: Offset for pagination.
- `include_preview` boolean: Include a small preview_html (first chunks) per document for thumbnails. The web Files view sets this; agents leave it off to stay token-light.
- `archived` boolean: When true, list your ARCHIVED (soft-deleted) documents instead of the live set — backs the Files view's Archived filter. Restore one with POST /v1/documents/{document_id}/unarchive.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)