---
title: "Get Transcript Paragraph Summary"
method: GET
path: "/v1/external/voice-file/jobs/{jobId}/transcript/paragraph-summary"
tags: ["Voice File"]
---

# Get Transcript Paragraph Summary

`GET /v1/external/voice-file/jobs/{jobId}/transcript/paragraph-summary`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/voice-file/jobs/{jobId}/transcript/paragraph-summary`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/tiro/apis/tiro-api/docs/v1/external/voice-file/jobs/:jobId/transcript/paragraph-summary/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve AI-generated paragraph summaries from the transcript.

- Provides a quick content overview in markdown format
- Summaries are generated in the transcript's original language

Documentation: [Paragraph Summary feature](/voice-file/overview#paragraph-summary-feature)

## Path parameters

- `jobId` string, required

## Response `200`

Transcript paragraph summary

- ParagraphSummary
  - `jobId` string, required: Voice file job identifier
  - `locale` string, required: Locale of the summary
  - `summary` TextObject, required
    - `type` 'text/plain' | 'text/markdown', required: MIME type of the text content
    - `content` string, required: The actual text content

## Other responses

- `401`: Unauthorized
- `404`: Job or summary not found

---

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