---
title: "Get Note Summary"
method: GET
path: "/v1/external/notes/{noteGuid}/summaries/{summaryId}"
tags: ["Note Summary"]
---

# Get Note Summary

`GET /v1/external/notes/{noteGuid}/summaries/{summaryId}`

## Request

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

Retrieve a specific summary with full content.

- Default format: Markdown (`text/markdown`)
- Use the `format` query parameter to request `text/plain` instead

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

## Path parameters

- `noteGuid` string, required
- `summaryId` integer, required

## Query parameters

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

## Response `200`

Summary with full content

- NoteSummary: A single block of summary text for a Note (the "one-page" summary). A Note can have multiple NoteSummaries in different languages or templates. Unlike NoteDocument, it is not divided into sections. See [Data Model](/fundamentals/note-data-model).
  - `id` integer, required: Summary ID
  - `noteGuid` string, required: Associated note GUID
  - `note` NoteRef, required: Note reference with minimal information
    - `guid` string, required: Note GUID
    - `webUrl` string, uri, required: Web URL to access the note
  - `template` NoteSummaryTemplate: Summary template information
    - `id` integer, required: Template ID
    - `title` string, required: Template title (e.g., One-Pager, Pitch)
  - `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
  - `content` TextObject, required
    - `type` 'text/plain' | 'text/markdown', required: MIME type of the text content
    - `content` string, required: The actual text content
  - `createdAt` string, date-time, required: Creation timestamp
  - `updatedAt` string, date-time, required: Last update timestamp

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