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 "Authorization: Bearer $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 uses scoring_weights.job_fit_weights, a tenant-level configuration value. It is not currently exposed as a self-serve dashboard or API setting — contact support if you need it customised for your tenant.