---
title: "Check Heygen Avatar Video"
method: GET
path: "/api/v1/video/check-heygen-avatar-video/{task_id}"
tags: ["video"]
---

# Check Heygen Avatar Video

`GET /api/v1/video/check-heygen-avatar-video/{task_id}`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/video/check-heygen-avatar-video/{task_id}`
- Auth: HTTP bearer

Check the status of a HeyGen avatar video generation task (single check)

This endpoint:
1. Retrieves the task from the database
2. Checks the current status with HeyGen API (single check, no polling)
3. Updates the task status based on the response
4. Returns video URLs (video_url, thumbnail_url, video_url_caption) when completed

Args:
    task_id: The internal task ID (UUID) returned from the create endpoint

Returns:
    dict with status and data:
    - status: "In Progress", "Done", or "Error"
    - data: Contains video_url, thumbnail_url, video_url_caption when completed
    
Note: This endpoint checks the status once and returns immediately.
The client should poll this endpoint if they need to wait for completion.

## Path parameters

- `task_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)