Skip to main content

Endpoint

GET /jobs/{job_id}

Example request

curl https://app.jobsbyhumans.com/api/v1/jobs/job_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "job_abc123",
  "name": "Q1 Catalog Scan",
  "status": "processing",
  "total": 100,
  "processed": 47,
  "succeeded": 45,
  "failed": 2,
  "verdict_counts": {
    "human": 38,
    "suspicious": 7
  },
  "created_at": "2026-02-27T10:00:00Z",
  "completed_at": null
}

Job status values

StatusDescription
queuedJob received, waiting to start
processingTracks are being analyzed
completeAll tracks finished
failedJob-level failure (e.g. bad manifest URL)