---
title: "Get a document by ID"
method: GET
path: "/api/v0/documents/{document_id}"
tags: ["Documents"]
---

# Get a document by ID

`GET /api/v0/documents/{document_id}`

Retrieves a document by its unique identifier.

## Path parameters

- `document_id` string, uuid, required

## Response `200`

Successful Response

- DocumentGetResponse
  - `id` string, uuid, required — The ID of the document.
  - `name` string, required — The name of the document.
  - `folder_id` string, uuid, nullable, required — The ID of the folder that contains the document.
  - `file_path` string, nullable, required — The path to the document file.
  - `file_type` string, required — The type of the document file. Options: `pdf`, `docx`, `txt`, `html`, `md`.
  - `file_url` string, nullable, required — The URL of the document file.
  - `renditions` DocumentRenditionResponse[] — Derived views of the file, one entry per kind — `pdf` for the paginated rendition, `mesh` for a 3D solid's tessellation. A viewer selects on which kinds are present, never on the file's extension.
    - `kind` string, required — What the rendition is: `pdf` (paginated) or `mesh` (3D solid).
    - `file_path` string, required — The storage path of the rendition.
    - `file_url` string, nullable — A signed URL for the rendition.
  - `summary` string, required — A summary of the document content.
  - `visibility` string, required — The visibility of the document. Options: `private`, `org`.
  - `num_pages` integer, required — The number of pages in the document.
  - `version` integer, required — The version of the document.
  - `job_status_id` string, uuid, nullable — The public UUID of the job status for the document's current processing job.
  - `job_status` string, nullable — The current job status: queued, processing, done, error, cancelled.
  - `created_at` string, date-time, required — The date and time the document was created.
  - `updated_at` string, date-time, required — The date and time the document was last updated.
  - `tags` string[], required — The tags associated with the document.

## Other responses

- `422` — Validation Error

---

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