List Jobs (Partial)

Retrieve jobs with a reduced payload, ideal for dashboards and polling where you only need lifecycle and status, not full per-model scores. Accepts the same filters, sorting, and paging as List Jobs. Soft-deleted jobs are excluded.

GET /v1/jobs/partial

Authentication

• Authentication is required. Include a valid df_ API key in the Authorization header, or rely on the machine-local default credential. See Authentication.

---

Query Parameters

All parameters are optional.

Parameter	Type	Default	Description	Required
job_id	number(int)	—	Get for a single job_id	No
status	string	—	Filter by job status (e.g. queued, processing, complete, error).	No
model	string	—	Return only jobs that included this model.	No
file_type	string	—	Filter by video, audio, or image.	No
title	string	—	Case-insensitive substring match on the job title.	No
limit	number(int)	50	Maximum records to return (clamped to 1–500).	No
offset	number(int)	0	Number of records to skip, for paging.	No
sort_by	string	created_at	One of id, status, title, file_type, created_at (date is an alias for created_at).	No
sort_order	string	desc	asc or desc.	No

---

Response

data is an array of reduced job records.

Field	Type	Description
id	number(int)	The edge job id.
title	string | null	The job label.
file_type	string | null	video, audio, or image.
status	string	The job status.
models	string[]	The models selected for the job.
core_job_id	number(int) | null	The underlying core processing id.
created_at / completed_at	timestamp | null	Lifecycle timestamps.
video_time / audio_time	number(float) | null	Lane processing time in seconds.
progress	number(float) | null	Completion percentage.
prediction_source	string | null	The scoring profile that scored the job — "default" or "name@version".
video_score / video_threshold	number(float) | null	Returned only for video jobs with visual models.
audio_score / audio_threshold	number(float) | null	Returned only for audio/video jobs with audio models.
image_score / image_threshold	number(float) | null	Returned only for image jobs.

{
  "status": true,
  "code": 200,
  "message": "Partial jobs fetched",
  "data": [
    {
      "id": 42,
      "title": "Q3 onboarding call",
      "file_type": "video",
      "status": "complete",
      "models": ["facia", "diffusion", "swintf", "audio"],
      "core_job_id": 128,
      "created_at": "2026-06-04T10:15:00Z",
      "completed_at": "2026-06-04T10:16:12Z",
      "video_time": 41.2,
      "audio_time": 12.8,
      "progress": 100.0,
      "video_score": 0.18,
      "video_threshold": 0.4,
      "audio_score": 0.07,
      "audio_threshold": 0.4
    }
  ]
}

---

Example Request

curl "http://<edge-host>:9123/v1/jobs/partial?status=processing" \
  -H "Authorization: Bearer df_..."