GET /v1/jobs/:id/match ACTIVE SERVICE

AI Match & Scoring Service

Calculates comprehensive multi-dimensional candidate-to-job match scores (0 to 100). Explains transparently why a role is a fit, highlighting matched skills, missing capabilities, experience requirements, and location preferences.

Multi-Factor Scoring Weights

1. Verified Skills Overlap (40%) 40 pts

Exact and semantic overlap between candidate skills and job requirements.

2. Experience Band Alignment (30%) 30 pts

Candidate total years experience compared against required minimum seniority.

3. Role & Domain Seniority (20%) 20 pts

Semantic keyword alignment across title, responsibilities, and headline.

4. Location & Remote Flexibility (10%) 10 pts

Remote availability or local city proximity match.

Match Score API Schema

GET /v1/jobs/:id/match

Response Payload:

{
  "ok": true,
  "match": {
    "score": 92,
    "matchedSkills": ["Node.js", "React", "PostgreSQL", "Docker", "REST APIs"],
    "missingSkills": ["GraphQL"],
    "explanation": "Matched 5 skills (Node.js, React, PostgreSQL, Docker). Experience: 8 years vs requirement. Role relevance: 20/20. Location fit: 10/10."
  }
}