Recruitment

Screen a CV against a role, in one call.

Send two strings. Get back name, years of experience, skills, strengths, gaps, a 0 to 100 fit score and interview questions. No protected characteristics, and the hiring decision stays with the human.

The call

The tool is live at POST /v1/agent/tools/screen_cv. Price is $0.20 per call and it bills only when the job succeeds.

curl https://api.fikraapi.co.ke/v1/agent/tools/screen_cv \
  -H "Authorization: Bearer $FIKRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cv":"Jane Doe, backend engineer, 4 years, Go and Postgres.",
       "job_description":"Senior backend engineer. 5+ years. Python and Postgres required."}'

What comes back

Structured JSON with candidate_name, years_experience, skills, strengths, gaps, fit_score_0_100, interview_questions and confidence. Missing values are null, never invented.

{"candidate_name":"Jane Doe","years_experience":4,
 "skills":["Go","Postgres"],"strengths":["backend depth"],
 "gaps":["no Python evidence","below 5 years"],
 "fit_score_0_100":62,"interview_questions":["Describe a Postgres migration you ran."],
 "confidence":0.86}

Comparing several candidates

For a shortlist, use the compare_candidates tool. It takes a job description and a list of CVs and returns per-candidate strengths and gaps plus a comparison. $0.30 per call.

POST /v1/products/compare_candidates
{"job_description":"...","cvs":["...","..."]}

Limits and safety

  • No inference of protected characteristics, and no automated hiring decision.
  • Documents are treated as data, not instructions.
  • Every call returns a receipt id you can reconcile.
  • Screen only CVs you are authorised to process.