Retrieve a screening | CONFIRM Docs

{
  "id": "scr_7Hq2mNfA8b",
  "candidate_id": "cand_5DkW9rTzPe",
  "external_ref": "cl_app_84321",
  "job_id": "job_2VbY6mQwXs",
  "status": "completed",
  "stage": "passed_screening_awaiting_scheduling",
  "attempt_count": 1,
  "next_attempt_at": null,
  "started_at": "2026-06-11T14:03:22Z",
  "completed_at": "2026-06-11T14:11:47Z",
  "outcome": "passed",
  "result": {
    "answers": [
      {
        "question": "Do you have an active Florida CNA or HHA license?",
        "answer_text": "Yes — I've held my Florida CNA license since 2021, it's current and in good standing.",
        "knockout": true,
        "knockout_passed": true,
        "audio_url": "https://api.confirm.global/partner/v1/media/ans_3kQ8xWvR?sig=…"
      },
      {
        "question": "Are you able to work in clients' homes in the Tampa area, including weekend shifts?",
        "answer_text": "Yes, I'm available weekends and have reliable transportation.",
        "knockout": true,
        "knockout_passed": true
      },
      {
        "question": "Tell me about your most recent caregiving role.",
        "answer_text": "I spent the last three years with a private-duty agency in Brandon, mostly long-term dementia-care clients.",
        "knockout": false,
        "knockout_passed": null
      }
    ],
    "summary": "Maria holds an active Florida CNA license (since 2021), is available for weekend in-home shifts in the Tampa area, and has three years of recent private-duty dementia-care experience. She passed both knockout questions and was engaged and clear throughout the call.",
    "signals": {
      "resume_fit": {
        "rating": "strong",
        "rationale": "Three years of private-duty dementia care closely matches the in-home caregiver role requirements."
      },
      "employment_stability": {
        "rating": "strong",
        "rationale": "Two employers over five years with no unexplained gaps."
      }
    }
  }
}

Retrieves a single screening, including the structured result payload once the screening is completed. Signals are item-level only — there is no composite or overall score.

Authentication

AuthorizationBearer

Partner API key sent as Authorization: Bearer cfk_.... Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Partner API key sent as `Authorization: Bearer cfk_...`. Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Path parameters

org_idstringRequired

Organization ID (org_...).

scr_idstringRequired

Screening ID (scr_...).

Response

The screening.

idstringOptional

Screening ID (scr_...).

candidate_idstringOptional

external_refstring or nullOptional

The candidate’s external_ref, echoed for correlation.

job_idstringOptional

statusenumOptional

Simplified partner-facing screening status. Flow: pending_contact → contacting → terminal (completed, no_answer_exhausted, declined_recording, opted_out, withdrawn). When completed, see outcome for passed vs failed_knockout. The candidate’s full v4 stage slug rides along as stage.

stageenumOptional

Candidate lifecycle stage slug (v4). Rides along on screenings as stage for partners who want full lifecycle granularity; most integrations only need the simplified partner screening status.

attempt_countintegerOptional

Outbound contact attempts made so far (voicemails and no-answers included).

next_attempt_atdatetime or nullOptional

When the next automatic contact attempt is scheduled, if any.

started_atdatetime or nullOptional

When the candidate first connected to the AI screening call.

completed_atdatetime or nullOptional

outcomeenumOptional

Set only when the screening status is completed.

resultobjectOptional

Structured result, present once the screening status is completed. Signals are item-level only — the Partner API intentionally exposes no composite or overall score.

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

$	curl https://api.confirm.global/partner/v1/organizations/org_4Nv8sJqKfH/screenings/scr_7Hq2mNfA8b \
>	-H "Authorization: Bearer <token>"