AI analysis

POST /jobs/{slug}/match-analysis Session or API key

Run the three-stage AI fit analysis and cache it.

Runs the fit prompt-chain over your stored CV and the job, caches the result, and returns it fresh (no credits on this response). Analysing a new job costs one AI credit; if you have none left it is a 402, and recomputing an already-analyzed job is free. has_cv is false when no CV is stored; a failing or unconfigured LLM returns a null analysis (200).

Path parameters

slug string required
The job public_slug.
curl
curl -X POST "https://freehire.dev/api/v1/jobs/<slug>/match-analysis" -H "Authorization: Bearer $FREEHIRE_API_KEY"
json — response
{
  "data": {
    "has_cv": true,
    "stale": false,
    "analysis": { "overall_score": 82, "verdict": "Strong Fit", "...": "..." }
  }
}