---
title: "Get document metadata"
method: GET
path: "/contents/v1/documents/{content_id}"
tags: ["Documents"]
---

# Get document metadata

`GET /contents/v1/documents/{content_id}`

Returns metadata for a single document by its content ID (the document id returned by List documents). Use this to check status, file_name, connector_id, tags, and timestamps. To retrieve the actual file content, use Get annotated document (structured JSON) or Get original document (original file format).

## Path parameters

- `content_id` string, required

## Response `200`

Document metadata (id, file_name, status, connector_id, tags, etc.). Use Get annotated document or Get original document with this id to download content.

- DocumentListItem — Metadata for a single document. Returned by List documents and Get document. Use the id (content_id) with Get annotated document or Get original document to retrieve the file content.
  - `id` string, required — Content ID: unique 32-character uppercase hexadecimal identifier for the document. Use this when calling Get document, Get annotated document, or Get original document.
  - `file_name` string, required — Original file name of the uploaded document.
  - `user_id` string, required — ID of the user who uploaded the document.
  - `org_id` string, required — ID of the organization the document belongs to.
  - `rp_collection_id` string — ID of the collection the document belongs to. This is applicable only for emails and attachments.
  - `raw_size` integer — Size of the raw document in bytes.
  - `request_origin` 'email' | 'investment_research' | 'sharepoint' | 'file_upload' — Origin of the content ingestion request: how the document entered the platform.
  - `content_type` string — MIME type of the document.
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required — Processing status of the document.
  - `shared_with_orgs` string[] — List of organization IDs the document is shared with.
  - `created_at` string, date-time, required — Timestamp when the document was created.
  - `updated_at` string, date-time, required — Timestamp when the document was last updated.
  - `published_at` string, date-time, required — Timestamp when the document was published. This is the reference timestamp used for search and retrieval.
  - `connector_id` string, uuid — ID of the connector used to upload the document.
  - `error_code` string, nullable — Error code if the document processing failed.
  - `delete_started_ts` string, date-time, nullable — Timestamp when document deletion started, if applicable.
  - `file_metadata` object, nullable — Additional metadata about the file.
  - `tags` Tag[] — Tags associated with the document.
    - `id` string, required — Unique identifier for the tag.
    - `name` string, required — Name of the tag (e.g. `from:user@email.com` for email; `broker:Broker Name` for investment research).

## Other responses

- `401` — Unauthorized - Invalid or missing API key.
- `403` — You do not have permission to access this document (e.g. not shared with your organization).
- `404` — No document found with this content_id.

---

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