Get screen

GET/api/jobs/:jobId/interviews/:interviewId

Returns one screen with its per-question scores. The messages array is part of the same response shape but rendered separately on the Get transcript page; this page focuses on the scoring fields.

Path parameters

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

Headers

Authorization header required. See Authentication.

Free vs Pro

Free-tier callers get an empty question_scores array and a summary truncated to 200 characters. is_pro in the response tells you which tier you are on.

Response

Returns an object with interview, messages, question_scores, and is_pro. recommendation is one of advance, hold, reject, or null while in progress. covered_question_ids lists the questions the AI actually got to (it can skip questions if the candidate exits early).

200 OK

json

{
  "interview": {
    "id": "7b1d3c0e-4f5a-4f2b-9e8c-5a6b1c2d3e4f",
    "job_id": "f4c2a1d8-9b3e-4d6a-b25f-1c0e8a7b3d52",
    "candidate_name": "Jordan Rivera",
    "candidate_email": "jordan@example.com",
    "status": "completed",
    "overall_score": 8.6,
    "summary": "Strong communicator with 3 years of memory care experience. Available evenings and weekends. Located 12 miles from facility.",
    "recommendation": "advance",
    "notes": null,
    "status_tag": null,
    "covered_question_ids": [
      "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e"
    ],
    "started_at": "2026-05-18T17:42:11.001Z",
    "completed_at": "2026-05-18T17:51:38.220Z",
    "duration_seconds": 567
  },
  "messages": [],
  "question_scores": [
    {
      "id": "3c4d5e6f-7a8b-9c0d-1e2f-3a4b5c6d7e8f",
      "interview_id": "7b1d3c0e-4f5a-4f2b-9e8c-5a6b1c2d3e4f",
      "question_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "score": 9,
      "reasoning": "Gave a clear example of de-escalating an agitated resident.",
      "answer_summary": "Used name and gentle redirection; called RN after.",
      "created_at": "2026-05-18T17:51:42.118Z",
      "question_text": "How do you handle an agitated resident?",
      "question_type": "behavioral"
    }
  ],
  "is_pro": true
}

Example request

curl

curl https://api.prelim.chat/api/jobs/f4c2a1d8-9b3e-4d6a-b25f-1c0e8a7b3d52/interviews/7b1d3c0e-4f5a-4f2b-9e8c-5a6b1c2d3e4f \
  -H "Authorization: Bearer prelim_8s4kZxQv3p2nLw1HfYBgRmTcEsK9aJdN0iUyXoVbPeWzCqA"