get
https://api.heygen.com/v1/video_status.get
Retrieves the status and details of a specific video by ID.
Note:
- The
thumbnail_url,video_urlandvideo_url_captionfields return time-limited links that expire after 7 days. The video itself does not expire, only the links do. To ensure continuous access, you have two options:
- Download the Video: Save the video locally within the 7-day window.
- Regenerate the URL: Call the endpoint again whenever you need to access the video file. Each time you call the video status endpoint, the
Expiresand related query parameters in the URL are regenerated, reflecting the new expiration time.- Scroll down to the Responses section below and expand the status code(s) to view the detailed response schema.
- Refer to the RESPONSE panel on the right and choose an example to explore different video processing statuses (such as waiting, pending, processing, completed, or failed) and see how each status appears in the API response examples.
