> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Export Project Transcript

> Retrieve an original or translated project transcript as JSON, SRT, or VTT

# Export Project Transcript

Retrieve a transcript from an existing VoiceCheap project without using internal web-app endpoints. The endpoint supports the source transcript and every available target-language transcript.
Successful requests return HTTP `200`.

## Request

**x-api-key** `string` *required*

Your VoiceCheap API key.

**projectId** `string` *required*

Project identifier returned by [Create Project](https://api-docs.voicecheap.ai/docs/api-reference/create-project.md) or [Start Translation](https://api-docs.voicecheap.ai/docs/api-reference/translate.md).

**source** `string` *required*

`original` or `translated`.

**targetLanguage** `string`

Required when `source` is `translated`. Use the target-language name stored on the project, such as `french`.

**outputFormat** `string` (default: json)

`json`, `srt`, or `vtt`.

**includeSpeakerLabels** `boolean` (default: false)

Include visible speaker labels in SRT or VTT. JSON always includes speaker numbers.

## Examples

```bash cURL — Original JSON theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "original",
    "outputFormat": "json"
  }'
```

```bash cURL — Translated SRT theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "translated",
    "targetLanguage": "french",
    "outputFormat": "srt",
    "includeSpeakerLabels": true
  }' \
  --output project_123-fr.srt
```

The JSON response uses the same normalized transcript structure documented in [Transcribe Media](https://api-docs.voicecheap.ai/docs/api-reference/transcribe.md). Stored project transcripts include segment timestamps, speakers, language, confidence data when available, and a `workId` for translated output.

## Pacing of translated segments

**segments\[].finalSpeedFactor** `number`

Translated transcripts only, once a voice was generated for the segment. Ratio between the duration of the generated
speech and the segment window, measured before the final tempo fit and rounded to three decimals. `1` means the
speech fits naturally; values above roughly `1.3` mean the audio had to be sped up noticeably, values below `0.9`
mean it was slowed down.

Use it to tune a [dub-only run](https://api-docs.voicecheap.ai/docs/api-reference/translate.md#dub-only-mode-bring-your-own-translation): export the
translated transcript as JSON, shorten the cues whose `finalSpeedFactor` is too high, and send the revised SRT to
[Dub Project](https://api-docs.voicecheap.ai/docs/api-reference/dub-project.md). The value reflects the last voice generated for the segment, so it is refreshed
by every run.

## Errors

| Status | Code | Description |
| - | - | - |
| 400 | `TARGET_LANGUAGE_REQUIRED` | Translated output was requested without a language |
| 401 | `INVALID_API_KEY` | API key is missing or invalid |
| 403 | `FORBIDDEN` | API key cannot access this project |
| 404 | `PROJECT_NOT_FOUND` | Project does not exist |
| 404 | `TRANSCRIPT_NOT_FOUND` | Requested source or translated transcript is absent |
| 409 | `TRANSCRIPT_NOT_READY` | Requested transcript is still processing |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.