Candidate Scoring

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

Optional inputs

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.