AI analysis

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

The cached AI fit analysis for the job (never runs the LLM).

Returns the cached analysis, flagged stale when your CV or the job changed since it was computed, or a null analysis when none is cached. has_cv is false when you have no stored CV. credits reports your AI-points balance and when it resets.

Path parameters

slug string required
The job public_slug.
curl 
curl "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",
      "dimensions": { "...": "..." },
      "requirement_match": [ { "text": "5+ years Go", "priority": "required", "status": "covered", "evidence": "..." } ],
      "strengths": ["..."],
      "gaps": ["..."],
      "recommendation": "..."
    },
    "credits": { "remaining": 17, "resets_at": "2026-08-01T00:00:00Z" }
  }
}