---
title: "Get Note Document"
method: GET
path: "/v1/external/notes/{noteGuid}/documents/{documentId}"
tags: ["Note Document"]
---

# Get Note Document

`GET /v1/external/notes/{noteGuid}/documents/{documentId}`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/notes/{noteGuid}/documents/{documentId}`
- Auth: HTTP bearer

Retrieve a specific note document by ID.

See [Template Based Documents](/template-based-documents/summary-and-document) for more details.

## Path parameters

- `noteGuid` string, required
- `documentId` integer, required

## Query parameters

- `format` 'text/plain' | 'text/markdown'

## Response `200`

Document details

- NoteDocument: A structured multi-section document (e.g., meeting minutes, action items) generated from a NoteDocumentTemplate. Unlike NoteSummary, it is divided into predefined sections. See [Data Model](/fundamentals/note-data-model).
  - `id` integer, required: Document ID
  - `noteGuid` string, required: The GUID of the note this document belongs to
  - `note` NoteRef, required: Note reference with minimal information
    - `guid` string, required: Note GUID
    - `webUrl` string, uri, required: Web URL to access the note
  - `template` NoteDocumentTemplateSummary, required: Summary information of a note document template
    - `id` integer, required: Template ID
    - `title` string, required: Template title
  - `locale` 'ko_KR' | 'en_US' | 'de_DE' | 'ja_JP' | 'es_ES' | 'fr_FR' | 'id_ID' | 'vi_VN' | 'tr_TR' | 'uk_UA' | 'ru_RU' | 'hi_IN' | 'it_IT' | 'zh_CN' | 'ms_MY' | 'th_TH' | 'sv_SE', required: Supported language locale
  - `sections` NoteDocumentSection[], required: Array of document sections
    - `templateSectionId` integer, required: ID of the template section this content was generated from
    - `content` object, required: Generated section content
      - `type` 'text/plain' | 'text/markdown', required: MIME type of the text content
      - `content` string, required: The actual text content
    - `createdAt` string, date-time, required: Section creation timestamp
  - `createdAt` string, date-time, required: Document creation timestamp
  - `updatedAt` string, date-time, required: Document last update timestamp
  - `truncated` boolean: `true` when the document was emitted as part of a deep-search response and its combined section text exceeded the search budget (5,000 chars). Plain document fetches always emit `false`.

## Other responses

- `401`: Unauthorized
- `404`: Not found. The note does not exist, or it is outside the read scope of the API key used. A system key reads only notes in a folder shared with all workspace members, and returns `404` (not `403`) for anything outside that scope so the response does not reveal whether the note exists. A note that used to be readable and now returns `404` may have moved into a private folder.

---

[API](https://skmtc.dev/tiro/apis/tiro-api-2.md) · [All operations](https://skmtc.dev/tiro/apis/tiro-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tiro/apis/tiro-api-2/revisions/dc1a260c6771?raw)