Skip to main content
GET
Get Task Status
Use the exact job_id returned at submission. This endpoint does not require an API key: the UUID in the URL is a capability token that grants access to the task result.
Keep the capability URL server-side. Do not put it in browser URLs, analytics, public logs, or screenshots.
Continue waiting through pending, staged, processing, and retry. Stop at completed or failed. A 404 means the identifier is unknown or the three-day task lookup window has expired.

Path Parameters

job_id
string<uuid>
required

The job_id returned at task creation.

Response

The task object.

config
object
required
detail
null
required

Reserved for future use; currently null in public API responses.

error
object
required
input
object
required

Echo of the task's input parameters (shape depends on task_type; mirrors the create-request body of the operation that created the task). Null in error responses.

job_id
string<uuid>
required

Task UUID. Pass it to GET /v1/job/{job_id} to poll, or reference it as jobId in follow-up operations.

logs
string[]
required

Operational log lines of the task (progress events, retries).

meta
object | null
required

Timestamps and billing usage of the task (null in error responses).

model
enum<string>
required

Model family that executed the task.

Available options:
midjourney
output
object
required

Task result, present once status is completed (null before that). Image/video tasks return URLs; describe/shorten tasks return text prompts.

status
enum<string>
required

Lifecycle state. Terminal states: completed, failed. staged means the task is queued behind the account's concurrency limit; retry means it is being resubmitted after a transient provider error.

Available options:
pending,
staged,
processing,
retry,
completed,
failed
task_type
enum<string>
required

Type of the task — the operation that created it.

Available options:
diffusion,
upscale,
reroll,
variation,
inpaint,
outpaint,
pan,
edit,
remix,
enhance,
upload_paint,
retexture,
remove_background,
shorten,
describe,
blend,
video_diffusion,
extend_video,
video_upscale,
enhance_upscale