---
title: "Async Retrieve Job"
method: GET
path: "/api/v1/tts/{jobId}"
tags: ["Text-to-Speech"]
---

# Async Retrieve Job

`GET /api/v1/tts/{jobId}`

Retrieve job result. It will return generated audio urls if job is successfully completed.

## Path parameters

- `jobId` string, required

## Response `200`

- TextToSpeechResponse
  - `id` string, mongoid, required — Id of the job returned. This id will be later used to check the progress of the TTS job.
  - `type` 'tts' | 'simple_tts' | 'dubbing' | 'localization' | 'subtitles', required — Type of the current job. Currently only TTS is supported.
  - `status` 'in_progress' | 'done', required
  - `progress` number, required
  - `team` string, required
  - `workspace` string
  - `project` string
  - `error` JobErrorResponse
    - `code` string, required
    - `message` string, required
  - `createdAt` string, date-time, required — TTS requested time.
  - `estimatedTimeAt` string, date-time — Job estimated timestamp in milliseconds
  - `estimatedTimeMs` number — Job estimated time in milliseconds
  - `callbackUrls` string[], required — Callback urls for any async job. This can be empty array.
  - `data` TextToSpeechOutput[], required
    - `status` 'pending' | 'succeeded' | 'failed', required — Status of the TTS request
    - `text` string, required
    - `speaker` string, mongoid, required
    - `speakerStyle` string, mongoid, required
    - `speed` number, required
    - `pause` Pause[], required
      - `position` number, required
      - `value` number, required
    - `emphasis` Emphasis[], required
      - `position` number, required
      - `value` 0.25 | 0.5 | 0.75, required
    - `urls` string[] — Audio URLs of the TTS request
    - `pronunciations` Pronunciation[], required — Pronunciations applied to the TTS request
      - `sourceWord` string, required
      - `targetWord` string, required
      - `isReplaced` boolean, required
    - `error` JobErrorResponse
      - `code` string, required
      - `message` string, required

## Other responses

- `400` — API key expired
- `401` — API key invalid
- `422` — Job not found

---

[API](https://skmtc.net/lovo/apis/genny-api.md) · [All operations](https://skmtc.net/lovo/apis/genny-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lovo/genny-api/revisions/5b03ec09cf3e/schema)