Job Status

Get Job Status

get/api/v0/job-statuses/{job_status_id}

Path parameters

job_status_idstring uuid required

Response

Successful Response

idstring uuid required

The ID of the job status.

statusstring required

The status of the job. Options: queued, processing, done, error, cancelled.

error_messagestring nullable required

The error message returned from the job, if any.

created_atstring date-time required

The date and time the job status was created.

worker_activeboolean nullable

Whether a worker is currently executing a per-page task for this job. None when the job has no per-page dispatch (e.g. single-task jobs) or has reached a terminal state. Allows clients to distinguish 'queued behind another job' from 'actively being processed' when status='processing' — the orchestrator flips status to 'processing' before fan-out, so the field alone is ambiguous on a single-worker stack.

tasks_completedinteger nullable

Number of per-page tasks that have reported completion for this job. None when the job has no per-page dispatch (e.g. single-task jobs) or has reached a terminal state. Pair with tasks_total to render fraction progress (e.g. '3 / 11 pages').

tasks_totalinteger nullable

Total number of per-page tasks this job dispatched. None when the job has no per-page dispatch or has reached a terminal state.

Changes

No recorded changes to this endpoint across all 1 revision of this API.