---
title: "Get video export status"
method: GET
path: "/v1/videos/{id}/exports/{exportId}"
tags: ["Videos"]
---

# Get video export status

`GET /v1/videos/{id}/exports/{exportId}`

## Request

- Base URL: `https://api.tella.com`
- URL: `https://api.tella.com/v1/videos/{id}/exports/{exportId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/exports/:exportId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current status and progress of an export. The download URL appears when the export is complete. The export ID contains slashes and must be percent-encoded as a single path segment. Requires edit access to the video, or viewer access to a video with downloads (or raw downloads) enabled.

## Path parameters

- `id` string, required: Unique video identifier
- `exportId` string, required: Export identifier returned when the export was started. The identifier contains slashes and must be encoded as a single path segment when constructing a URL manually.

## Response `200`

OK

- GetExportResponse: Current status of a video export
  - `export` ExportStatus, required: Status of a video export job
    - `downloadUrl` string, uri, nullable, required: Download URL when export is completed, null otherwise
    - `exportId` string, required: Unique identifier for the export job
    - `progress` number, nullable, required: Export progress percentage (0-100), null if not started
    - `status` 'queued' | 'running' | 'completed' | 'failed', required: Current export status
    - `updatedAt` string, date-time, required: ISO 8601 datetime of last status update

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication is required. Provide a valid API key.
- `403`: You don't have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429`: You have exceeded the rate limit. Please slow down.
- `500`: An unexpected error occurred
- `501`: The requested operation is not implemented.
- `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 71 revisions in range; 1 not diffed.

- **2026-09-28** `ac47c99c144f`: 9 warning
  - added the new `edit_conflict` enum value to the `error` response property for the response status `400`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `401`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `403`
  - added the new `edit_conflict` enum value to the `error` response property for the response status `404`
  - …5 more
- **2026-09-09** `6b1132ef42fb`: 14 warning, 2 info
  - added the new `conflict` enum value to the `error` response property for the response status `400`
  - added the new `conflict` enum value to the `error` response property for the response status `401`
  - added the new `conflict` enum value to the `error` response property for the response status `403`
  - added the new `conflict` enum value to the `error` response property for the response status `404`
  - …12 more

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/:id/exports/:exportId/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/a500b6d75f79?raw)