Skip to main content
GET
/
api
/
public
/
v1
/
export
/
status
/
{job_id}
curl -X GET "https://app.hoox.video/api/public/v1/export/status/export_abcd1234" \
  -H "Authorization: Bearer your_api_key"

{
  "job_id": "export_abcd1234",
  "status": "pending",
  "progress": 0,
  "current_step": "render"
}

​
Overview

This endpoint allows you to check the current status of a video export job. Use this to monitor export progress and retrieve the download URL when the export is complete.

​
Authentication

This endpoint requires API key authentication. Include your API key in the Authorization header.

​
Path Parameters

​
jobId
string
required
The export job ID returned from the /export/start endpoint.

​
Response

​
job_id
string
The unique identifier for the export job.
​
status
string
Current export status:
  • pending: Export is queued and waiting to start
  • processing: Export is in progress
  • completed: Export finished successfully
  • failed: Export failed
​
progress
number
Progress percentage (0-100).
​
current_step
string
Description of the current processing step.
​
result
object
Available when status is completed:
​
error
object
Available when status is failed:

​
Example

curl -X GET "https://app.hoox.video/api/public/v1/export/status/export_abcd1234" \
  -H "Authorization: Bearer your_api_key"

{
  "job_id": "export_abcd1234",
  "status": "pending",
  "progress": 0,
  "current_step": "render"
}

​
Polling Best Practices

Recommended polling strategy for exports:
  1. Start with 3-second intervals (exports are typically faster than generation)
  2. Increase to 5-second intervals after 30 seconds
  3. Increase to 10-second intervals after 2 minutes
  4. Use webhooks for more efficient status updates

​
Export Steps

During processing, you’ll see various current_step values:
  • “render-audio”: Processing audio in for the avatar export step
  • “avatar”: Processing avatar generation
  • “render”: Rendering the final video file

​
Download URL Details

Important notes about download URLs:
  • URLs are valid for 7 from completion
  • Download the file to your own storage for permanent access

​
Error Codes

Common error codes you might encounter:
  • JOB_NOT_FOUND: Export job ID doesn’t exist
  • UNAUTHORIZED_JOB: Export job doesn’t belong to your space
  • EXPORT_FAILED: General export failure
  • ENCODING_FAILED: Video encoding failed
  • FORMAT_CONVERSION_FAILED: Failed to convert video format
  • STORAGE_FAILED: Failed to upload to storage