Skip to main content

​
Endpoint

GET /jobs/{job_id}/results
Results are returned as newline-delimited JSON (NDJSON) — one record per line. This format is efficient for streaming large result sets.

​
Example request

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

​
Response (NDJSON)

{"item_id":"track-001","status":"success","verdict":"human","tier_verdicts":{"press_safe":"human","human_safe":"human","recall":"human"},"scores":{"truth_score":0.12,"geo_score":0.18},...}
{"item_id":"track-002","status":"success","verdict":"suspicious","tier_verdicts":{"press_safe":null,"human_safe":"suspicious","recall":"suspicious"},"scores":{"truth_score":0.79,"geo_score":0.71},...}
{"item_id":"track-003","status":"failed","verdict":null,"error":"audio_load_failed"}
Each record matches the full result schema. See Reading Results for field descriptions.

​
Filtering

Query paramValuesDescription
verdicthuman, suspiciousFilter by verdict
statussuccess, failedFilter by processing status
pageintegerPage number (default: 1)
per_pageintegerResults per page (default: 500, max: 1000)
# Only return suspicious tracks
curl "https://app.jobsbyhumans.com/api/v1/jobs/job_abc123/results?verdict=suspicious" \
  -H "Authorization: Bearer YOUR_API_KEY"