---
title: "Get Video"
method: GET
path: "/videos/{id}"
tags: ["Video"]
---

# Get Video

`GET /videos/{id}`

## Request

- Base URL: `https://myworkspace.myclickfunnels.com/api/v2`
- URL: `https://myworkspace.myclickfunnels.com/api/v2/videos/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://accounts.myclickfunnels.com/oauth/authorize`
    - Token URL: `https://accounts.myclickfunnels.com/oauth/token`
- TypeScript: <https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/docs/videos/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Response `200`

OK

- VideoAttributes
  - `id` integer: Video ID
  - `public_id` string: Public ID
  - `workspace_id` integer: Workspace ID
  - `name` string: Video name
  - `status` 'queued' | 'processing' | 'ready' | 'failed': Computed import state. Poll until ready before attaching to a lesson.
  - `error_code` 'download_failed' | 'file_too_large' | 'invalid_file_type' | 'processing_failed' | 'null', nullable: Null unless failed. Network and URL download failures share download_failed. An import that stops progressing for 3 hours fails with processing_failed.
  - `metadata` object, nullable: Details of the processed file; null until the video has one.
    - `filename` string, nullable: Stored filename.
    - `mime_type` string, nullable: Server-detected MIME type.
    - `duration` number, nullable: Duration in seconds.
    - `width` integer, nullable: Width in pixels.
    - `height` integer, nullable: Height in pixels.
  - `poster_image_id` integer, nullable: Poster image ID in this workspace.
  - `url` string, nullable: Signed MP4 URL, expires one hour after this response; null until the video has a processed file. Fetch again to renew. No HLS URL is exposed.
  - `thumbnail_url` string, nullable: Signed generated frame URL, expires one day after this response; null until the video has a processed file.
  - `created_at` string, date-time: Added
  - `updated_at` string, date-time: Updated

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `511d88b30aea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/changes/videos/:id/get.md)

---

[API](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api.md) - [All operations](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/revisions/511d88b30aea?raw)