For HR software and recruiting teams
AI resume screening with scores recruiters can check
Parse each application, rank the candidates against the job in one call, then open any score to see the requirement it rests on. HireLayer gives your screening feature its evidence; the decision stays with the recruiter.
Why screening is hard to get right
Most teams already screen with filters and a fast read. The trouble starts when volume grows or someone asks why a candidate was set aside.
- 01
The first applications get the attention
With a few hundred CVs per role, recruiters read the top of the list closely and skim the rest.
- 02
Keyword filters miss equivalent experience
“Led a support team of six” does not contain “people management”, so a filter drops a candidate a recruiter would keep.
- 03
A bare score does not survive a question
A hiring manager asks why one profile ranks above another. “The tool said 0.82” is not an answer.
- 04
Regulators expect explanations
The EU AI Act lists filtering applications and evaluating candidates as high-risk. Screening needs reasons a person can review.
From application to reviewed shortlist
Your product keeps the jobs, the applications and the decision. HireLayer structures each document and returns scores with their reasons.
- Your system
Step 1, your system: Applications arrive
Your ATS or careers page receives the CV files for a job, as it does today.
- HireLayer
Step 2, HireLayer API: Parse each CV
One call per file returns the candidate record, stored under your application id for screening.
POST /
api/ v4/ resumes/ parse - application_id
- resume.work_experiences[]
- resume.skills[]
- HireLayer
Step 3, HireLayer API: Turn the job into criteria
Once per job, the description becomes weighted requirements, each required, preferred or bonus. A recruiter adjusts them before screening starts.
POST /
api/ v4/ jobs/ extract-criteria - job_id
- criteria[]
- HireLayer
Step 4, HireLayer API: Rank the pool
Send the job and the candidates in one request, with precise_ranking on. Each comes back once, best first, with a rank, a score from 0 to 1, a verdict and a ranking reason.
POST /
api/ v4/ resumes/ score - scores[].rank
- scores[].ranking_reason
- HireLayer
Step 5, HireLayer API: Explain the finalists
Every score carries the evaluation of each criterion: met, partial, missing or unknown, with the evidence from the CV. The profiles a recruiter opens need no second call.
- scores[].criteria[]
- Your system
Step 6, your system: The recruiter decides
Your interface shows the order and the reasons. Advancing or rejecting a candidate remains a person’s action, logged in your product.
Want the whole flow as a program you can run on your own CVs?
Read the screening guideA ranked queue where every score opens up
What a screening view in your product can show with Resume Scorer results. Ranking reasons and explanations come from the API, in the job’s language; the decision buttons are yours.
Rank three applications for one job
Resume Scorer takes the stored job and the parsed CVs by their ids, so there is no text to send. The answer is abridged: each score also carries a summary and the evaluation of every criterion.
- application_id
- Your application id, the one each CV was parsed under.
- score · verdict
- From 0 to 1, the weighted mean of the criterion scores, and an overall judgment from highly_relevant to not_relevant.
- ranking_reason
- Why the candidate holds this position, in the job’s language.
curl -X POST https://hirelayer.co/api/v4/resumes/score \
-H "Content-Type: application/json" \
-H "X-API-Key: $HIRELAYER_API_KEY" \
-d '{
"job": { "job_id": "csm-lyon" },
"resumes": [
{ "application_id": "app_1041" },
{ "application_id": "app_1042" },
{ "application_id": "app_1043" }
],
"precise_ranking": true
}'{
"job": { "job_id": "csm-lyon", "title": "Customer Success Manager", "language": "en" },
"precise_ranking": true,
"scores": [
{
"rank": 1,
"application_id": "app_1042",
"score": 0.86,
"verdict": "highly_relevant",
"ranking_reason": "Four years of B2B SaaS account management and fluent English, shown by a role in London."
},
{
"rank": 2,
"application_id": "app_1041",
"score": 0.71,
"verdict": "relevant",
"ranking_reason": "Solid SaaS customer experience, but the level of English is not stated."
},
{
"rank": 3,
"application_id": "app_1043",
"score": 0.48,
"verdict": "marginally_relevant",
"ranking_reason": "Technical support profile, little evidence of account management."
}
],
"credits_used": 3
}The HireLayer APIs behind this workflow
Start with the core APIs, add the others when a feature needs them. All six products share one API key and one credit balance.
- HireLayer Resume Scorer
Candidate & Job Matching API
Core to this workflowDocs for HireLayer Resume ScorerScores each application requirement by requirement, with the evidence from the CV; its precise_ranking option orders them, each with a ranking reason.
- HireLayer Resume Parser
Resume Parsing API
Core to this workflowDocs for HireLayer Resume ParserTurns each CV file into a record and the text used for screening.
- HireLayer Job Criteria Extractor
Job Parsing API
Add when neededDocs for HireLayer Job Criteria ExtractorTurns the job description into weighted criteria a recruiter can edit.
- HireLayer Skills Normalizer
Skills Matching API
Add when neededDocs for HireLayer Skills NormalizerNormalizes skill labels so filters and search agree across CVs.
What changes for recruiters and your product
Every application gets read
The pool is ranked against the same job, so a strong CV at the bottom of the inbox is not missed.
Equivalent experience counts
Requirements are evaluated from what the CV describes, not from a list of exact keywords.
Scores that can be explained
Each status points to a sentence in the CV, so a recruiter can answer a hiring manager or a candidate.
A person stays in charge
HireLayer returns an order and reasons. Your product records who advanced or rejected each candidate.
AI resume screening: frequently asked questions
What is the best AI resume screening API to add to an ATS?
Is resume parsing the same as resume screening?
What is AI resume screening?
Does HireLayer reject candidates automatically?
How many applications can be screened at once?
Is AI resume screening high-risk under the EU AI Act?
How much does screening one job cost?
Can recruiters screen candidates from ChatGPT or Claude?
What language are rationales and explanations written in?
Screen one real job with it
Take a job you are hiring for, parse its applications and compare the order with your recruiters’ own. The free plan includes 50 credits a month, shared by all six products.
Also built on HireLayer
- ATS platformsParse CVs on upload and show recruiters why a candidate fits.
- Recruitment agenciesTurn client briefs into criteria and evidence-backed shortlists.
- HR software & SaaSShip CV, job and skills features under your own brand.
Implementation guides
- Build an AI resume screener in PythonScore every CV against reviewed criteria and explain each one.
- Candidate matching APIs comparedStateless or index-based, explained or not: eight APIs side by side.
- EU AI Act checklist for recruiting softwareWhat high-risk rules mean for screening tools, and when.
- MCP servers for recruitingParse, match and rank candidates from Claude, ChatGPT or Cursor.