> ## Documentation Index > Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get video export status > 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. ## OpenAPI ````yaml /openapi.json get /v1/videos/{id}/exports/{exportId} openapi: 3.0.3 info: description: >- The Tella Public API allows you to programmatically access your videos and playlists, including transcripts, chapters, and thumbnails. ## Authentication All requests require a Bearer token in the Authorization header: ``` Authorization: Bearer tella_pk_xxxxx... ``` API keys can be generated in your Tella workspace settings. ## Rate Limiting The API is rate-limited to 100 requests per minute per organization. Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests per window - `X-RateLimit-Remaining`: Remaining requests in current window - `X-RateLimit-Reset`: Unix timestamp when the window resets title: Tella Public API version: 1.0.0 servers: - description: Production url: https://api.tella.com security: [] tags: - description: Video operations name: Videos - description: Sections of a video name: Clips - description: Playlist operations name: Playlists - description: Sidebar groups for organizing playlists name: Playlist Groups - description: Tags for categorizing and filtering videos name: Tags - description: Webhook endpoint management name: Webhooks paths: /v1/videos/{id}/exports/{exportId}: get: tags: - Videos summary: Get video export status description: >- 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. operationId: getVideoExport parameters: - description: Unique video identifier in: path name: id required: true schema: description: Unique video identifier example: vid_abc123def456 type: string - description: >- 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. in: path name: exportId required: true schema: description: >- 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. example: >- Export-Story-vid_abc123def456/2026-01-15T10:00:00Z/Story/1920x1080/30FPS type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/GetExportResponse' description: OK '400': $ref: '#/components/responses/400ErrorResponse' '401': $ref: '#/components/responses/401ErrorResponse' '403': $ref: '#/components/responses/403ErrorResponse' '404': $ref: '#/components/responses/404ErrorResponse' '422': $ref: '#/components/responses/422ErrorResponse' '429': $ref: '#/components/responses/429ErrorResponse' '500': $ref: '#/components/responses/500ErrorResponse' security: - BearerAuth: [] components: schemas: GetExportResponse: additionalProperties: false description: Current status of a video export properties: export: $ref: '#/components/schemas/ExportStatus' required: - export type: object ExportStatus: additionalProperties: false description: Status of a video export job properties: downloadUrl: description: Download URL when export is completed, null otherwise example: https://cdn.tella.tv/exports/vid_abc123/video.mp4 format: uri nullable: true type: string exportId: description: Unique identifier for the export job example: >- Export-Story-vid_abc123def456/2026-01-15T10:00:00Z/Story/1920x1080/30FPS type: string progress: description: Export progress percentage (0-100), null if not started example: 100 maximum: 100 minimum: 0 nullable: true type: number status: description: Current export status enum: - queued - running - completed - failed example: completed type: string updatedAt: description: ISO 8601 datetime of last status update example: '2024-01-15T15:00:00.000Z' format: date-time type: string required: - exportId - status - progress - downloadUrl - updatedAt type: object ErrorResponse: additionalProperties: false description: Standard error response format properties: error: additionalProperties: false description: Error details properties: code: description: Machine-readable error code enum: - bad_request - unauthorized - forbidden - not_found - unprocessable_entity - rate_limit_exceeded - internal_server_error example: not_found type: string doc_url: description: Link to documentation for this error example: https://tella.tv/docs/api-reference/errors#not-found format: uri type: string message: description: Human-readable error message example: The requested resource was not found. type: string required: - code - message - doc_url type: object required: - error type: object responses: 400ErrorResponse: content: application/json: example: error: code: bad_request doc_url: https://tella.tv/docs/api-reference/errors#bad-request message: The request was malformed or contained invalid parameters. schema: $ref: '#/components/schemas/ErrorResponse' description: The request was malformed or contained invalid parameters. 401ErrorResponse: content: application/json: example: error: code: unauthorized doc_url: https://tella.tv/docs/api-reference/errors#unauthorized message: Authentication is required. Provide a valid API key. schema: $ref: '#/components/schemas/ErrorResponse' description: Authentication is required. Provide a valid API key. 403ErrorResponse: content: application/json: example: error: code: forbidden doc_url: https://tella.tv/docs/api-reference/errors#forbidden message: You don't have permission to access this resource. schema: $ref: '#/components/schemas/ErrorResponse' description: You don't have permission to access this resource. 404ErrorResponse: content: application/json: example: error: code: not_found doc_url: https://tella.tv/docs/api-reference/errors#not-found message: The requested resource was not found. schema: $ref: '#/components/schemas/ErrorResponse' description: The requested resource was not found. 422ErrorResponse: content: application/json: example: error: code: unprocessable_entity doc_url: https://tella.tv/docs/api-reference/errors#unprocessable-entity message: The request was well-formed but contained semantic errors. schema: $ref: '#/components/schemas/ErrorResponse' description: The request was well-formed but contained semantic errors. 429ErrorResponse: content: application/json: example: error: code: rate_limit_exceeded doc_url: https://tella.tv/docs/api-reference/errors#rate-limit-exceeded message: You have exceeded the rate limit. Please slow down. schema: $ref: '#/components/schemas/ErrorResponse' description: You have exceeded the rate limit. Please slow down. 500ErrorResponse: content: application/json: example: error: code: internal_server_error doc_url: https://tella.tv/docs/api-reference/errors#internal-server-error message: An unexpected error occurred on the server. schema: $ref: '#/components/schemas/ErrorResponse' description: An unexpected error occurred on the server. securitySchemes: BearerAuth: description: API key obtained from your Tella account settings scheme: bearer type: http ````