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

# List Documents

`GET /v2/documents`

Retrieve a list of documents.

## Query parameters

- `limit` integer
- `page` integer
- `sort` 'ascending' | 'descending'
- `status` string
- `name_or_uuid` string
- `tags` string

## Response `200`

List of documents

- object
  - `data` object[] — Documents for the current page; use `total_count` for the full count under the applied filters.
    - `document_id` string — Unique identifier for the document
    - `document_name` string — Name of the document
    - `document_url` string — URL of the document
    - `status` 'started' | 'processing' | 'ready' | 'error' | 'recrawling' — Current status of the document processing. Possible values: `started`, `processing`, `ready`, `error`, `recrawling`.
    - `progress` integer, nullable — Processing progress as a percentage (0-100). Null when processing has not started or is complete.
    - `error_message` string, nullable — Error code indicating why processing failed. Only present when status is `error`. Possible values include: `file_download_failed`, `file_format_unsupported`, `file_size_too_large`, `file_empty`, `invalid_file_url`, `document_processing_failed`, `website_processing_failed`, `chunking_failed`, `embedding_failed`, `vector_store_failed`, `contact_support`.
    - `created_at` string — ISO 8601 timestamp of when the document was created
    - `updated_at` string — ISO 8601 timestamp of when the document was last updated
    - `callback_url` string — URL that receives status updates
    - `tags` string[] — Array of document tags
    - `crawl_config` object, nullable — The crawl configuration used for this document (only present for crawled websites)
      - `depth` integer — Crawl depth setting
      - `max_pages` integer — Maximum pages setting
    - `crawled_urls` string[], nullable — List of URLs that were crawled (only present for crawled websites after processing completes)
    - `last_crawled_at` string, nullable — ISO 8601 timestamp of when the document was last crawled
    - `crawl_count` integer, nullable — Number of times the document has been crawled
  - `total_count` integer — Total number of documents matching the filter criteria
  - `page` integer — Current page number
  - `limit` integer — Number of documents per page

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)