> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sacra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Documents

> Sacra's research reports on private companies and markets

A **document** is a piece of original Sacra research — a report, interview, or market analysis produced by Sacra's analyst team. Documents are the primary way Sacra publishes qualitative insight on private companies, and they're the source of much of the data that flows into the rest of the platform.

## Document types

Sacra produces three types of documents:

| Type          | Description                                                                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Company**   | In-depth reports on individual companies — covering business model, revenue, growth, competitive position, and Sacra's analysis.                                    |
| **Interview** | Transcripts and edited conversations with founders, executives, and buyers. Buyer interviews in particular capture how customers experience and evaluate a product. |
| **Market**    | Research covering a sector, theme, or competitive landscape. Market reports serve as a catch-all for analysis that isn't scoped to a single company.                |

The `type` field on every document is one of `company`, `interview`, or `market`.

## Company relationships

A document can be related to a company in one of two ways:

* **`subject`** — the company is the primary focus of the document
* **`connected`** — the company is mentioned or analyzed within a document whose primary subject is something else

When you fetch documents for a specific company, both subject and connected documents are returned, each with a `relation` field indicating which applies.

## Document content

The full document content is available through the [detail endpoint](/api-reference/documents/get-a-document). The body is parsed into structured **sections**, each with a `type`, `title`, and `elements` array. Sections are linked with `prev_section` and `next_section` pointers for sequential navigation, and a `table_of_contents` provides an outline of the full document.

Additional metadata includes:

* `reading_time` — estimated reading time in minutes
* `has_images` — whether the document contains image elements
* `pdf_url` — direct link to the PDF on S3
* `web_url` — link to the document page on sacra.com

## Querying documents

The documents endpoint supports two modes:

**Company query** — pass `company_domain` or `company_id` to get all documents related to a specific company. Returns a flat, unpaginated list ordered by relevance.

**Global query** — omit company filters to search across all documents. Requires a `created_at` or `updated_at` date range of 14 days or less, and returns paginated results.

<Tip>Use `updated_at_gte` for incremental syncs — see [Sync Sacra Research & Data](/guides/syncing-data) for a complete polling guide. Documents can be revised after initial publication, so polling by update time ensures you don't miss changes to existing reports.</Tip>