Skip to main content
GET
/
api
/
screening
/
candidate
/
{candidateId}
Get Screenings for Candidate
curl --request GET \
  --url https://api.example.com/api/screening/candidate/{candidateId}
{
  "screenings": [
    {
      "id": 789,
      "candidateId": 456,
      "jobId": 123,
      "currentScore": 66.67,
      "potentialScore": 100,
      "disqualify": false,
      "criteria": [
        {
          "id": 1,
          "source": "job_criteria",
          "question": "How many years of ICU nursing experience do you have?",
          "criteria": "Minimum of 3 years ICU nursing experience required",
          "type": "YearsOfExperience",
          "status": "PartiallyMet",
          "reasoning": "The candidate has 2 years of ICU experience...",
          "textEvidence": "2 years of experience in Medical ICU"
        }
      ],
      "qualificationLevel": "Appropriate",
      "isRelevant": true,
      "job": {
        "id": 123,
        "title": "ICU Nurse",
        "location": "San Francisco, CA",
        "department": "Nursing"
      },
      "createdAt": "2024-03-19T18:30:00Z"
    }
  ],
  "total": 5,
  "limit": 50,
  "offset": 0
}
Retrieve all screening results for a given candidate across all jobs they’ve been screened against.

​
Path Parameters

​
candidateId
integer
required
ID of the candidate to get screenings for

​
Query Parameters

​
status
string
Filter by screening status (e.g., “qualified”, “disqualified”)
​
jobId
integer
Filter by specific job ID
​
limit
integer
default:"50"
Maximum number of screenings to return
​
offset
integer
default:"0"
Number of screenings to skip for pagination

​
Response Fields

​
screenings
array
Array of screening results
​
total
integer
Total number of screenings found
​
limit
integer
Maximum number of screenings returned
​
offset
integer
Number of screenings skipped
{
  "screenings": [
    {
      "id": 789,
      "candidateId": 456,
      "jobId": 123,
      "currentScore": 66.67,
      "potentialScore": 100,
      "disqualify": false,
      "criteria": [
        {
          "id": 1,
          "source": "job_criteria",
          "question": "How many years of ICU nursing experience do you have?",
          "criteria": "Minimum of 3 years ICU nursing experience required",
          "type": "YearsOfExperience",
          "status": "PartiallyMet",
          "reasoning": "The candidate has 2 years of ICU experience...",
          "textEvidence": "2 years of experience in Medical ICU"
        }
      ],
      "qualificationLevel": "Appropriate",
      "isRelevant": true,
      "job": {
        "id": 123,
        "title": "ICU Nurse",
        "location": "San Francisco, CA",
        "department": "Nursing"
      },
      "createdAt": "2024-03-19T18:30:00Z"
    }
  ],
  "total": 5,
  "limit": 50,
  "offset": 0
}