Candidate Prescreen
Automatically prescreen a candidate against a job description — scoring fit, surfacing strengths and concerns, and recommending whether to proceed.
POST /v1/hiring/candidate-prescreen
Employer-facing intent. Evaluates a candidate's profile against a job description and returns a structured prescreening report: overall scores, a proceed/decline recommendation, cited strengths and concerns, risk flags, and recommended interview focus areas.
Required inputs
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID (e.g. recruiter ID) |
input.profile | ProfileInput | Candidate's structured profile |
input.job_description | JobDescriptionInput | Role requirements |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.resume | ResumeInput | Resume text to supplement profile data |
Example request
Response
Recommendation values
| Value | Meaning |
|---|---|
strong_proceed | Highly qualified — prioritise in pipeline |
proceed | Meets requirements — advance to next stage |
review | Partial match — human review recommended |
decline | Does not meet minimum requirements |
Concern severities
| Value | Meaning |
|---|---|
blocker | Disqualifying if confirmed |
significant | Meaningful gap to probe in interview |
minor | Small gap unlikely to affect performance |