Skip to main content
GET
Get Job Detail

Overview

The Get Job Status API allows you to check the current status of any asynchronous job in the GoEnhance platform. This is a universal endpoint that works with all job types, including video generation, image processing, and other time-consuming operations.

How It Works

When you initiate an asynchronous operation through any of our APIs, you receive a job identifier (img_uuid). You can use this identifier with the Get Job Status API to track the progress of your job until it completes.

Job Status Values

The API returns a status field with one of the following values:
  • pending: Job is queued and waiting to be processed
  • processing: Job is currently being processed
  • success: Job has finished successfully
  • failed: Job has failed with an error

Usage Example

This endpoint is typically used in a polling pattern:
  1. Submit an asynchronous job request
  2. Receive an img_uuid in the response
  3. Periodically call the Get Job Status API with that img_uuid
  4. When status is “success”, retrieve your results

Result Entries (json[])

When status is success, data.json holds one entry per produced asset:
duration is processing time, not the length of the media. Upscaling a 5-second clip that took just over 91 seconds of GPU time reports duration: 90.901 — it does not mean the output video is 91 seconds long. If you need the length of a generated video, read it from the file itself.
Result URLs are temporary. Download the file before link_expired_at; GoEnhance does not keep a permanent copy, and the link cannot be renewed. See Best Practices for a recommended download flow.

Callback Instead of Polling

If you don’t want to poll, pass a top-level custom_callback_url when creating the task — GoEnhance will POST this same payload to your server on every status change. See Task Callback for details.

Example Response

A video job carries the same shape. Note that duration (90.901) is the processing time — the upscaled clip itself is about 5 seconds long:

Headers

Authorization
string

Query Parameters

img_uuid
string

Response

code
integer
required
msg
string
required
data
object
required