Candidate Scoring
Score and rank a candidate against a role using the same structured evaluation as prescreening.
POST /v1/hiring/candidate-scoring
Employer-facing intent. Produces a quantitative score for a candidate against a role. Uses the same output schema as candidate-prescreen. Use this when you want a score to power ranking or comparison logic in your application, rather than a full narrative prescreening report.
Required inputs
| Field | Type | Notes |
|---|---|---|
input.user_id | string | Your platform's user ID |
input.profile | ProfileInput | Candidate's structured profile |
input.job_description | JobDescriptionInput | Role to score against |
Optional inputs
| Field | Type | Notes |
|---|---|---|
input.resume | ResumeInput | Resume text for additional evidence |
Example request
curl -X POST https://api.liyaengine.ai/v1/hiring/candidate-scoring \
-H "x-api-key: $LIYA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"user_id": "recruiter_456",
"profile": { ... },
"job_description": { ... }
}
}'Response
Same structure as candidate-prescreen. The overall_score, fit_score, skill_score, and experience_score fields are the primary outputs for ranking use cases.
Scoring at scale
To score multiple candidates against a single role, call this endpoint once per candidate. The response scores are comparable within the same role — you can sort by overall_score to rank candidates.
Scoring weights can be customised per tenant via scoringWeights.job_fit_weights in your account configuration.