Skip to main content

​
Endpoint

curl -X GET https://api.fairmatch.ai/api/jobs/{job_id}/evaluations

​
Path parameters

​
job_id
string
required
The unique identifier of the job to retrieve evaluation results for

​
How it works

This endpoint retrieves all stored evaluation results for a specific job. Use this after running an evaluation to fetch the results, or to retrieve previously computed evaluations without re-running the analysis.

​
Response

Returns an array of evaluation results for all candidates who have been evaluated for this job.
​
candidate_id
string
The unique identifier of the evaluated candidate
​
job_id
string
The job posting identifier
​
name
string
The candidate’s full name
​
skill_score
integer
Score based on how well the candidate’s skills match the job requirements (0-100)
​
github_score
integer
Score based on the candidate’s GitHub profile and projects (0-100)
​
interview_score
integer
Score based on interview responses (0-100)
​
experience_score
integer
Score based on years of experience relative to requirements (0-100)
​
integrity_score
integer
Score assessing the candidate’s authenticity and integrity (0-100)
​
final_score
integer
Weighted final score combining all evaluation factors (0-100)
​
strengths
array
List of the candidate’s key strengths identified during evaluation
​
weaknesses
array
List of areas where the candidate may need improvement
​
risk_level
string
Assessment of hiring risk (e.g., “Low”, “Medium”, “High”)
​
recommendation
string
Final hiring recommendation: “Strong Hire”, “Hire”, or “Reject”

​
Response example

[
  {
    "candidate_id": "a1b2c3d4",
    "job_id": "job_123",
    "name": "Sarah Johnson",
    "skill_score": 92,
    "github_score": 88,
    "interview_score": 85,
    "experience_score": 90,
    "integrity_score": 95,
    "final_score": 90,
    "strengths": [
      "Strong Python and React skills",
      "Active GitHub contributor",
      "5+ years relevant experience"
    ],
    "weaknesses": [
      "Limited TypeScript experience",
      "No AWS certifications"
    ],
    "risk_level": "Low",
    "recommendation": "Strong Hire"
  },
  {
    "candidate_id": "e5f6g7h8",
    "job_id": "job_123",
    "name": "Michael Chen",
    "skill_score": 78,
    "github_score": 72,
    "interview_score": 80,
    "experience_score": 70,
    "integrity_score": 88,
    "final_score": 77,
    "strengths": [
      "Good problem-solving skills",
      "Team player"
    ],
    "weaknesses": [
      "Limited PostgreSQL experience",
      "Fewer years of experience than preferred"
    ],
    "risk_level": "Medium",
    "recommendation": "Hire"
  }
]

​
Error responses

​
detail
string
Error message describing what went wrong

​
Status codes

  • 200 - Results retrieved successfully (may be an empty array if no evaluations have been run)
  • 500 - Internal server error
If you receive an empty array, it means no evaluations have been run for this job yet. Use the Run evaluation endpoint to generate results.

Build docs developers (and LLMs) love

Get started for freeTalk to us