Evaluate Jobs

Evaluates the fit for a set of jobs against a candidate.

Use this endpoint to evaluate the fit of jobs presented to a job seeker, based on their fit as a candidate. This endpoint accepts one or more jobs and a single candidate and returns matches for each pair. A match consists of a match score assessing the fit between a job and the candidate and a skills report which identifies skill overlaps and skill gaps.

Additional Notes:

  • 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 jobs_scores.match_report.skills is the latest version, is introduced in Match, and is recommended for new integrators. The version in jobs_scores.skills will be deprecated in the coming months.
Language
Credentials
Header
Click Try It! to start a request and see the response here!