Job Get

• Retrieves detailed information about jobs, including their status and analysis results. You can fetch all jobs or filter by specific criteria.

GET /v1/job/get/full

Auth and Rate Limits

• Authentication is required for this endpoint. You must include a valid API key in the Authorization header.
• This API call is rate limited to 100 requests per minute.

---

Query Parameters

• All parameters are optional and can be used to filter and sort the results.

Parameter	Type	Description	Required
job_id	integer	Filter by specific job ID	No
file_id	string	Filter by file ID (UUID)	No
status	string	Filter by job status (e.g., "completed", "submitted")	No
model	string	Filter by model type ("facia", "diffusion", "swintf", "audio")	No
order_by	string	Sort direction ("asc", "desc"). Legacy alias for sort_order	No
limit	integer	Limit number of results	No
offset	integer	Pagination offset (use with limit)	No
sort_by	string	Sort field: "date", "created_at", "id", "status", "title", "file_type"	No
sort_order	string	Sort direction: "asc" or "desc" (default: "desc")	No
user_id	string	Filter by user ID (for multi-user org queries)	No
scope	string	"mine" (default) returns only your own jobs; "org" returns every job in your organization. See Organization-wide access.	No

---

Organization-wide access

By default this endpoint returns only the jobs created by the API key's own user. Pass scope=org to list every job in your organization instead.

• scope=org requires an admin or sub-admin role in that organization; any other role is rejected with 403.
• An unrecognised value is rejected with 422.
• The organization is taken from your API key — there is nothing extra to send.

curl "https://api.deepfaic.com/v1/job/get/full?scope=org&limit=50" \
  -H "Authorization: Bearer <api_key>"

---

Response

{
	"status": true,
	"code": 200,
	"message": "Job fetched successfully",
	"data": [
		{
			"audio": {
				"chunk_scores": [
					0.6623894858078649,
					0.803149147442714
				],
				"coverage": 1.0,
				"error": null,
				"frame_scores": [
					0.6128998079975659,
					0.7118791636181638,
					0.7096528722750773,
					0.8966454226103507,
					0.8354772230121912
				],
				"score": 0.8425193179541712,
				"status": "complete",
				"threshold": 0.4,
				"topk_chunk_indexes": [
					1
				]
			},
			"job": {
				"created_at": "2026-01-12T02:27:19.732Z",
				"file_name": "0021.mp4",
				"file_type": "video",
				"id": 2879,
				"length": "00:00:06",
				"progress": 100.0,
				"status": "complete",
				"stream_state": null,
				"title": "0021.mp4"
			},
			"video": {
				"chunk_scores": [
					0.724148335250119,
					0.7211285001478722
				],
				"coverage": 1.0,
				"error": null,
				"face_box": [
					[
						83.63,
						-39.04,
						299.65,
						265.28
					],
					[
						79.8,
						-20.45,
						291.53,
						273.75
					],
					...
				],
				"frame_index": [
					1,
					4,
					7,
					11,
					14,
					...
				],
				"frame_percent": 0.3,
				"frame_scores": [
					0.6664099339962006,
					0.7333099339962006,
					0.7182599339962006,
					...
				],
				"score": 0.7793186682000952,
				"status": "complete",
				"threshold": 0.4,
				"topk_chunk_indexes": [
					0
				]
			}
		}
	]
}

---

Example Request

curl "https://api.deepfaic.com/v1/job/get/full" \
  -H "Authorization: Bearer <api_key>"

---

Additional Response Fields

The response may also include the following fields per job, depending on processing state:

Per-model results — Each job includes a models object with the score and status for each model:

"models": {
  "facia":     { "score": 0.95, "status": "complete", "error": null },
  "diffusion": { "score": 0.87, "status": "complete", "error": null },
  "swintf":    { "score": 0.91, "status": "complete", "error": null },
  "audio":     { "score": 0.72, "status": "complete", "error": null },
  "dfaudio":   { "score": null, "status": null,       "error": null },
  "object":    { "score": null, "status": null,       "error": null }
}

Status info:

"statusInfo": {
  "status": "completed",
  "statusText": "Detection Complete",
  "isComplete": true,
  "hasError": false,
  "isInProgress": false
}