---
title: "Get Document"
method: GET
path: "/v2/documents/{document_id}"
tags: ["Documents"]
---

# Get Document

`GET /v2/documents/{document_id}`

Retrieve detailed information about a specific document using its unique identifier.

## Path parameters

- `document_id` string, required

## Response `200`

Document details

- object
  - `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

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[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)