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

# Get Translation Paragraph Summary

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

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/voice-file/jobs/{jobId}/translations/{locale}/paragraph-summary`
- Auth: HTTP bearer

Retrieve AI-generated paragraph summaries from a translated version.

- Summaries are generated in the target translation language
- Requires the translation to exist for the specified locale

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

## Path parameters

- `jobId` string, required
- `locale` string, required

## Response `200`

Translation 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, translation, 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)