---
title: "Get document"
method: GET
path: "/v3/documents/{id}"
tags: ["Manage Documents"]
---

# Get document

`GET /v3/documents/{id}`

Get a document by ID

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved document

- object — Document object
  - `connectionId` string, nullable, required
  - `content` string, nullable, required — The content to extract and process into a document. This can be a URL to a website, a PDF, an image, or a video. Plaintext: Any plaintext format URL: A URL to a website, PDF, image, or video We automatically detect the content type from the url's response format.
  - `containerTags` string[] — Optional tags this document should be containerized by. This can be an ID for your user, a project ID, or any other identifier you wish to use to group documents.
  - `createdAt` string, datetime, required — Creation timestamp
  - `customId` string, nullable, required — Optional custom ID of the document. This could be an ID from your database that will uniquely identify this document.
  - `id` string, required — Unique identifier of the document.
  - `metadata` union, required
    - string
    - number
    - boolean
    - object
    - unknown[]
      - unknown
  - `ogImage` string, nullable, required
  - `raw` string, nullable, required — Raw content of the document
  - `source` string, nullable, required — Source of the document
  - `status` 'unknown' | 'queued' | 'extracting' | 'chunking' | 'embedding' | 'indexing' | 'done' | 'failed', required — Status of the document
  - `summary` string, nullable, required — Summary of the document content
  - `title` string, nullable, required — Title of the document
  - `type` 'text' | 'pdf' | 'tweet' | 'google_doc' | 'google_slide' | 'google_sheet' | 'image' | 'video' | 'audio' | 'notion_doc' | 'webpage' | 'onedrive' | 'github_markdown', required — Type of the document
  - `updatedAt` string, datetime, required — Last update timestamp
  - `url` string, nullable
  - `spatialPoint` unknown, required

## Other responses

- `401` — Unauthorized
- `404` — Document not found
- `500` — Internal server error

## Changes

- **2026-03-12** `83aebd1251bc` — 1 warning
  - added the new `audio` enum value to the `type` response property for the response status `200`
- **2026-02-09** `4b4ababc7fb5` — 1 info
  - response property `containerTags` deprecated
- **2026-02-09** `d09553cd7c35` — 1 info
  - added the required property `spatialPoint` to the response with the `200` status
- **2026-01-28** `228aa031e151` — 1 info
  - api operation id `getV3Documents:id` removed and replaced with `getV3DocumentsById`
- **2026-01-20** `9fef3190aa1b` — 5 breaking
  - removed the required property `summaryEmbeddingHv` from the response with the `200` status
  - removed the required property `summaryEmbeddingModel` from the response with the `200` status
  - removed the required property `summaryEmbeddingModelHv` from the response with the `200` status
  - removed the required property `summaryEmbeddingModelNew` from the response with the `200` status
  - …1 more

[Full history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v3/documents/:id/get.md)

---

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