The Match object includes an evaluation and explanation of the fit between a Candidate and a Job. This includes a match score and category, and a Match Report with supporting/explanatory details. The Match Report includes:

  • "attribute scores" for work history, skills, and education,
  • a skills report detailing the candidate's competence for the job's key technical and baseline skills,
  • an education report detailing whether the candidate meets the job's education requirements,
  • a certifications report* detailing whether the candidate meets the job's education requirements, and
  • a narrative explanation* of the match assessment.

*Certifications report and match narrative are currently in beta and not included in the standard Match Report.

Match Schema

Match Score

Each match is scored using a numerical match score between 0 and 1 and a match score category: Very High, High, Medium, Low. See Descriptions of Match Score Categories for category details.

FIELDTYPESHORT DESCRIPTION
match_scorefloatNumerical assessment between 0 and 1 of the match between a candidate and a job.
match_score_categorystringCategorical description of the match score.

Match Report

The Match Report explains the match score, providing details on the assessed fit in work history, skills, education, and certifications.

FIELDTYPESHORT DESCRIPTION
attributesobjectA set of attribute scores for the candidate. See below for schema details.
skillsobjectSkill Reports for both technical and baseline skills.
educationobjectA comparison between the education level required for the job and held by the candidate.
certificationsobjectA comparison between the certifications requested in the job description and held by the candidate.

Attribute Scores

To better explain the overall match assessment to end users, the match score is segmented into attributes that assess the candidate’s fit based on skills, work experience, and education. See Descriptions of Match Score Categories for category details.

FIELDTYPESHORT DESCRIPTION
skills_categorystringCategorical value assessing candidate's skill fit for a role. (Values include Very High, High, Medium, and Low)
work_history_categorystringCategorical value assessing candidate's work experience and seniority fit for a role.
education_categorystringCategorical value assessing candidate's education fit for a role.

Skills Report

The Skills Report assesses the candidate's competence for the job's key technical and baseline skills. AdeptID identifies key skills for the job based on the skills listed in the job description and AdeptID's advanced skill inference models (which predict what skills are required based on the job title and other attested skills). Similarly, candidate competence is based on both attestation in resumes and inference from other skills and work experience. The skill taxonomy section includes additional information about skills and their associated metadata. See Descriptions of Match Score Categories for category details.

In the Skills report, skills are grouped into technical and baseline skills.

FIELDTYPESHORT DESCRIPTION
technicalarray of objectsList of Skill objects for key technical skills. See below for schema details.
baselinearray of objectsList of Skill objects for key baseline skills. See below for schema details.

Skill Object

FIELDTYPESHORT DESCRIPTION
rankintThe ranked importance of the skill for the job, with 0 being the most important.
skill_namestringSkill name.
skill_clusterstringName of a group of similar skills. This can be used for organizing lists of skills.
attested_jobbooleanWhether or not the skill was listed in the job description.
attested_candidatebooleanWhether or not the skill was listed in the candidate profile/resume.
assessment_categoryenumCategorical description of the candidate's skill competency.

Education Report

The education report compares the minimum degree level required by the job with the highest degree level attained by the candidate.

FIELDTYPESHORT DESCRIPTION
job_degree_minenumThe minimum degree level required by the job.
candidate_degree_maxenumThe highest degree level attained by the candidate.
meets_requirementenumWhether the candidate does not meet, meets, or exceeds the requirement.

Certifications Report

The certifications report compares the job-required certifications with those held by the candidate. It also lists additional certifications held by the candidate but not required by the job.

FIELDTYPESHORT DESCRIPTION
job_requiredarray of objectsList of Certification objects for job-required certifications.
candidate_otherarray of stringsList of additional certifications held by the candidate.

Certification Object

FIELDTYPESHORT DESCRIPTION
namestringCertification name.
attested_candidatebooleanWhether or not the certification was listed in the candidate profile/resume.
meets_requirementenumWhether the candidate does not meet, meets, or exceeds the requirement.

Match Narrative

The match narrative provides a Generative AI-created synopsis of the match, drawing from the details in the Match Report. (Available in Beta)

FIELDTYPESHORT DESCRIPTION
narrativestringGenerative AI-created synopsis of the match.

Category Definitions

Descriptions of Match Categories

The following descriptions apply to Match Score, Attribute Scores, and the Skills Report.

CATEGORYFROMTODESCRIPTION
VERY HIGH0.91.0Outstanding matches warranting immediate action (an application, an interview, etc.). Typically ~20% of matches for large candidate pools.
HIGH0.8<0.9Good matches warranting action (an application, an interview, etc.), with small and addressable gaps. Typically ~30% of matches for large candidate pools.
MEDIUM0.7<0.8Decent matches that can potentially warrant action (an application, an interview, etc.) when Very High or High matches do not exist or are in short supply. These matches have multiple gaps/shortcomings, but also multiple strengths. Typically ~25% of matches for large candidate pools.
LOW0.0<0.7Poor matches with many gaps/shortcomings that do not warrant action (an application, an interview, etc.). Typically ~25% of matches for large candidate pools.

Mapping Skill Competencies to Skill Overlaps and Gaps

Some organizations choose to present skill competency assessments as overlaps and gaps for the job. The below table provides a mapping between competency categories (assessment_category) in the Skills Report and an overlap/gap-oriented presentation to users.

CATEGORYMAPPINGDESCRIPTION
VERY HIGHLARGE OVERLAPLarge Skill Overlap: A candidate almost certainly possesses direct experience with the relevant skill. This should be considered a highly positive indicator for their application.
HIGHOVERLAPSkill Overlap: A candidate likely possesses direct experience with, or adjacent and transferable skills to, the relevant skill. This should be considered a positive indicator for their application.
MEDIUMNEUTRALNeutral: It is unclear the degree to which the candidate possesses direct experience with, or adjacent and transferable skills to, the relevant skill. This should not be considered a positive or negative indicator for their application.
LOWGAPSkill Gap: A candidate almost certainly lacks direct experience with, or adjacent and transferable skills to, the relevant skill. This should be considered a negative indicator for their application.

Match Example

{
    "candidates_scores": {
        "Piya Gupta": {
            "match_score": 0.8164023756980896,
            "match_score_category": "High",
            "match_report": {
                "attributes": {
                    "education_category": "Low",
                    "skills_category": "High",
                    "work_history_category": "High"
                },
                "skills": {
                    "technical": [
                        {
                            "rank": 0,
                            "skill_name": "Marketing",
                            "skill_cluster": "Marketing Strategy and Techniques",
                            "attested_job": true,
                            "attested_candidate": true,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 1,
                            "skill_name": "Social Media",
                            "skill_cluster": "Social Media",
                            "attested_job": false,
                            "attested_candidate": true,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 2,
                            "skill_name": "Marketing Communications",
                            "skill_cluster": "Communication",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Medium"
                        },
                        {
                            "rank": 3,
                            "skill_name": "Digital Marketing",
                            "skill_cluster": "Digital Marketing",
                            "attested_job": true,
                            "attested_candidate": false,
                            "assessment_category": "Medium"
                        },
                        {
                            "rank": 4,
                            "skill_name": "Marketing Materials",
                            "skill_cluster": "Promotions and Campaigns",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 5,
                            "skill_name": "Marketing Strategies",
                            "skill_cluster": "Marketing Strategy and Techniques",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Low"
                        },
                        {
                            "rank": 6,
                            "skill_name": "Lead Generation",
                            "skill_cluster": "Prospecting and Qualification",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Low"
                        },
                        {
                            "rank": 7,
                            "skill_name": "Marketing Management",
                            "skill_cluster": "Marketing Strategy and Techniques",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Low"
                        },
                        {
                            "rank": 8,
                            "skill_name": "Content Creation",
                            "skill_cluster": "Content Development and Management",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Medium"
                        },
                        {
                            "rank": 9,
                            "skill_name": "Proofreading",
                            "skill_cluster": "Writing and Editing",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Medium"
                        }
                    ],
                    "baseline": [
                        {
                            "rank": 0,
                            "skill_name": "Self-Motivation",
                            "skill_cluster": "Initiative and Leadership",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 1,
                            "skill_name": "Communication",
                            "skill_cluster": "Communication",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 2,
                            "skill_name": "Verbal Communication Skills",
                            "skill_cluster": "Communication",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 3,
                            "skill_name": "Time Management",
                            "skill_cluster": "Initiative and Leadership",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 4,
                            "skill_name": "Ability To Meet Deadlines",
                            "skill_cluster": "Initiative and Leadership",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 5,
                            "skill_name": "Interpersonal Communications",
                            "skill_cluster": "Communication",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 6,
                            "skill_name": "Planning",
                            "skill_cluster": "Initiative and Leadership",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "High"
                        },
                        {
                            "rank": 7,
                            "skill_name": "Problem Solving",
                            "skill_cluster": "Critical Thinking and Problem Solving",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 8,
                            "skill_name": "Prioritization",
                            "skill_cluster": "Project Management",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "Very High"
                        },
                        {
                            "rank": 9,
                            "skill_name": "Microsoft Office",
                            "skill_cluster": "Office and Productivity Equipment and Technology",
                            "attested_job": false,
                            "attested_candidate": false,
                            "assessment_category": "High"
                        }
                    ]
                },
                "education": {
                    "job_degree_min": "BACHELORS",
                    "candidate_degree_max": "ASSOCIATES",
                    "meets_requirement": "Does not meet"
                }
            }
        }
    }
}