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

# Get Transcript

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

## Request

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

Retrieve the transcribed text from a completed Voice File Job.

- Job status must be `COMPLETED`
- Returns the full transcript text and detected locales

Documentation: [How to retrieve results](/voice-file/tutorial#step-5-retrieve-results)

## Path parameters

- `jobId` string, required

## Response `200`

Transcript data

- Transcript
  - `jobId` string, required: Associated job identifier
  - `locales` string[], required: Locales used for transcription
  - `text` string, required: Transcribed text
  - `segments` TranscriptSegment[]: Optional sentence-level timestamps and speaker labels. Empty when no segment data is available.
    - `startTimeMillis` integer, required: Segment start offset from the beginning of the audio, in milliseconds
    - `endTimeMillis` integer, required: Segment end offset from the beginning of the audio, in milliseconds
    - `text` string, required: Transcribed text for this segment
    - `speakerLabel` string, nullable: Opaque speaker label that is meaningful only within this job. Null when diarization does not assign a speaker.

## Other responses

- `401`: Unauthorized
- `404`: Job or transcript 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)