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

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
- `422`: `422013 unprocessable_entity` when the summary is not ready yet. Wait for the `voice_file_job.completed` event, then retry. `422014 unprocessable_entity` when summary generation failed. The summary is not available for this job.

---

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