List a candidate's screenings

{
  "data": [
    {
      "id": "scr_7Hq2mNfA8b",
      "candidate_id": "cand_5DkW9rTzPe",
      "external_ref": "cl_app_84321",
      "job_id": "job_2VbY6mQwXs",
      "status": "pending_contact",
      "stage": "applied",
      "attempt_count": 1,
      "next_attempt_at": "2024-01-15T09:30:00Z",
      "started_at": "2024-01-15T09:30:00Z",
      "completed_at": "2024-01-15T09:30:00Z",
      "outcome": "passed",
      "result": {
        "answers": [
          {
            "question": "Do you have an active Florida CNA or HHA license?",
            "answer_text": "string",
            "knockout": true,
            "knockout_passed": true,
            "audio_url": "string"
          }
        ],
        "summary": "string",
        "signals": {
          "resume_fit": {
            "rating": "strong",
            "rationale": "string"
          },
          "employment_stability": {
            "rating": "strong",
            "rationale": "string"
          }
        }
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Returns a cursor-paginated list of the candidate’s screenings, newest first (reapplications can produce more than one).

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_...).

cand_idstringRequired

Candidate ID (cand_...).

Query parameters

limitintegerOptional1-100Defaults to 20

Page size, 1–100.

cursorstringOptional

Opaque cursor from a previous response’s next_cursor.

Response

Paginated screening list.

datalist of objectsOptional

has_morebooleanOptional

next_cursorstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

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