Skip to main content
GET
/
videos
/
{video_id}
Get the status of a motion graphics video
curl --request GET \
  --url https://api.hera.video/v1/videos/{video_id} \
  --header 'x-api-key: <api-key>'
{
  "video_id": "vid_abcde12345",
  "status": "in-progress",
  "outputs": [
    {
      "status": "in-progress",
      "config": {
        "format": "mp4",
        "aspect_ratio": "16:9",
        "fps": "24",
        "resolution": "360p"
      },
      "file_url": "<string>",
      "error": "<string>"
    }
  ],
  "project_url": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Your API key for authenticating requests.

Path Parameters

​
video_id
string
required

The unique video/job ID returned when creating the job.

Response

Full export status and list of outputs for the specified video/job.

Complete status object and output info for a generated video job.

​
video_id
string
required

Unique ID of this job/video.

Example:

"vid_abcde12345"

​
status
enum<string>
required

High-level status of the export job (in-progress, success, failed).

Available options:
in-progress,
success,
failed
​
outputs
object[]
required

Detailed export output statuses for each configuration requested.

​
project_url
string

Optional user interface URL for this project.