ATS scoring

Every applicant’s resume is parsed and scored against the job’s ATS criteria — the must-haves, nice-to-haves, and weighting defined on the job. The result is a 0–100 score plus a breakdown you can read over the API.

The pipeline

1. A candidate applies; their resume is parsed into structured data (skills, experience, education, projects, summary).
2. The parsed resume is scored against the job’s criteria.
3. Score and breakdown land on the application, ready to filter and sort by.

Parsing and scoring are asynchronous — a just-submitted application may briefly return { "resume": null } or { "ats": null } until the pipeline completes.

Reading scores

• Filter and sort candidate lists by score: GET /api/v1/jobs/:jobId/applications?sort=ats-desc&atsScoreMin=75 — see Candidates.
• Read the breakdown for one candidate: GET /api/v1/applications/:id/ats returns the overall score, matched/missing keywords, strengths, concerns, and per-criterion detail.

Rerunning a score

If the job description or criteria change after candidates applied, their scores are stale. Trigger a re-score with POST /api/v1/applications/:id/ats/rerun.

Judgment stays with you

The score ranks; it doesn’t decide. The API deliberately exposes the inputs too — the parsed resume and the per-criterion breakdown — so a reviewer (or Claude) can weigh a strong candidate the keyword match undersold.