Skip to main content
GET
/
api
/
screening
/
job
/
{jobId}
Get Screenings for Job
curl --request GET \
  --url https://api.example.com/api/screening/job/{jobId}
{
  "screenings": [
    {
      "id": 789,
      "candidateId": 456,
      "jobId": 123,
      "currentScore": 66.67,
      "potentialScore": 100,
      "disqualify": false,
      "summary": {
        "screeningSummary": "The candidate meets most critical requirements including ICU experience and certifications...",
        "followUpQuestions": [
          "Are you willing and able to work night shifts?"
        ],
        "missingInformation": [
          "Night shift availability"
        ],
        "strengths": [
          "Current ACLS and BLS certifications"
        ],
        "gaps": [
          "Experience level slightly below requirement"
        ]
      },
      "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,
      "candidate": {
        "id": 456,
        "name": "Jane Smith",
        "location": "San Francisco, CA",
        "yearsOfExperience": 2
      },
      "createdAt": "2024-03-19T18:30:00Z"
    }
  ],
  "total": 12,
  "limit": 50,
  "offset": 0
}
Retrieve all screening results for a given job across all candidates who have been screened against it.

​
Path Parameters

​
jobId
integer
required
ID of the job to get screenings for

​
Query Parameters

​
status
string
Filter by screening status (e.g., “qualified”, “disqualified”)
​
minScore
number
Filter by minimum current score (0-100)
​
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,
      "summary": {
        "screeningSummary": "The candidate meets most critical requirements including ICU experience and certifications...",
        "followUpQuestions": [
          "Are you willing and able to work night shifts?"
        ],
        "missingInformation": [
          "Night shift availability"
        ],
        "strengths": [
          "Current ACLS and BLS certifications"
        ],
        "gaps": [
          "Experience level slightly below requirement"
        ]
      },
      "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,
      "candidate": {
        "id": 456,
        "name": "Jane Smith",
        "location": "San Francisco, CA",
        "yearsOfExperience": 2
      },
      "createdAt": "2024-03-19T18:30:00Z"
    }
  ],
  "total": 12,
  "limit": 50,
  "offset": 0
}