Get Video

GET /v1/videos/:id

Retrieve a single video by its ID.

Path parameters

Parameter	Type	Required	Description
id	string	Yes	Video ID (e.g. vid_1708300000000_abc1234)

Example

curl https://api.vidocu.ai/v1/videos/vid_1708300000000_abc1234 \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "id": "vid_1708300000000_abc1234",
  "name": "Product Demo Q1",
  "status": "completed",
  "videoUrl": "https://storage.vidocu.ai/...",
  "thumbnailUrl": "https://storage.vidocu.ai/...",
  "videoDuration": 120.5,
  "language": "en",
  "exportedVideoUrl": "https://storage.vidocu.ai/...",
  "exportedSrtUrl": "https://storage.vidocu.ai/...",
  "exportedVoiceoverUrl": "https://storage.vidocu.ai/...",
  "exportedAt": "2024-02-19T10:30:00.000Z",
  "createdAt": "2024-02-18T14:00:00.000Z",
  "updatedAt": "2024-02-19T10:30:00.000Z"
}

See List Videos for the full field reference.

Errors

Status	Code	Cause
401	authentication_error	Invalid or missing API key
404	not_found	Video does not exist or belongs to a different workspace