Get job analytics

GET/api/jobs/:jobId/analytics

Returns completion rate, average score trended by week, and an interview status breakdown for one job.

Pro plan only

Free-tier callers get 403 Pro subscription required. Check Get current user for the caller's subscription status before requesting analytics.

Path parameters

Name	Type	Required	Description
`jobId`	uuid	yes	UUID of the job.

Headers

Authorization header required. See Authentication.

Response

completion_rate is an integer percentage of total screens that reached completed. average_score_by_week bins completed screens by the Monday of their completion week.

200 OK

json

{
  "completion_rate": 78,
  "average_score_by_week": [
    { "week": "2026-04-27", "average_score": 6.8, "count": 9 },
    { "week": "2026-05-04", "average_score": 7.1, "count": 14 },
    { "week": "2026-05-11", "average_score": 7.6, "count": 12 },
    { "week": "2026-05-18", "average_score": 7.9, "count": 12 }
  ],
  "interviews_by_status": {
    "completed": 47,
    "in_progress": 9,
    "expired": 4
  },
  "total_interviews": 60
}

Free-tier response

403 Forbidden

json

{
  "error": "Pro subscription required",
  "upgrade_url": "/dashboard/billing"
}

Example request

curl

curl https://api.prelim.chat/api/jobs/f4c2a1d8-9b3e-4d6a-b25f-1c0e8a7b3d52/analytics \
  -H "Authorization: Bearer prelim_8s4kZxQv3p2nLw1HfYBgRmTcEsK9aJdN0iUyXoVbPeWzCqA"