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

# List Note Documents

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

## Request

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

List all documents generated for a specific note.

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

## Path parameters

- `noteGuid` string, required

## Query parameters

- `templateId` integer

## Response `200`

List of documents

- NoteDocumentListResponse: Response containing list of note documents
  - `content` NoteDocumentListItem[], required: Array of document summaries
    - `id` integer, required: Document ID
    - `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
    - `createdAt` string, date-time, required: Document creation timestamp
    - `updatedAt` string, date-time, required: Document last update timestamp
  - `totalSize` integer: Total number of documents

## 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)