Evaluate Candidates

Use this endpoint to provide candidate evaluations to hiring managers or recruiters. This endpoint accepts one or more candidates and a single job and returns matches for each pair. A match consists of a match score assessing the fit between a candidate and the job and a skills report which identifies skill overlaps and skill gaps.

Additional Notes:

• Feedback Collection: Evaluate Candidates Feedback can be used to collect and share user feedback on the results of this endpoint.
• Empty Skills Report: In rare cases, the returned evaluation may not list any skill overlaps or gaps in the skills report. We suggest presenting users with the following error message when this occurs: We were unable to complete a skills analysis for this application. This is usually related to difficulty analyzing skills related to the specific job title, and does not indicate a problem with the match score.
• Dates: If both are populated within an object, start_date cannot be after end_date.
• Skills Report: The current response schema includes two versions of a "Skills Report". The version in candidate_scores.match_report.skills is the latest version, is introduced in Match, and is recommended for new integrators. The version in candidate_scores.skills will be deprecated in the coming months.
• ID Uniqueness: If the same ID is used for multiple jobs, or multiple candidates, in an Evaluate Candidates submission, AdeptID will not be able to attribute Job Application Events to the correct application.