The match object includes an evaluation and explanation of the fit between a candidate and a job. This includes a match score and category, independent attribute scores for work experience, skills, and education, a skills report describing skill gaps and overlaps, and a narrative explanation of the match quality.

Match Schema

Summary Score

Each match is scored using a numerical match score between 0 and 1 and a match score category: Very High, High, Medium, Low.

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.

Description of Match Score Categories

CATEGORYFROMTODESCRIPTION
VERY HIGH0.91.0Outstanding matches that warrant immediate action (an application, an interview, etc.). Typically ~20% of matches for large customers.
HIGH0.8<0.9Good matches that warrant action (an application, an interview, etc.), with small and addressable gaps. Typically ~30% of matches for large customers.
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 customers.
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 customers.

Attribute Scores

To ensure matches are explainable, the overall match score is segmented into attribute match scores that assess the candidate’s fit based on skills, work experience, seniority, and education. (Available in Beta)

FIELDTYPESHORT DESCRIPTION
skill_match_scorefloatNumerical assessment between 0 and 1 of the candidate’s skills match.
skill_match_score_categorystringCategorical description of the candidate’s skill match score.
work_experience_match_scorefloatNumerical assessment between 0 and 1 of the candidate’s work experience match.
work_experience_match_score_categorystringCategorical description of the candidate’s work experience match score.
seniority_match_scorefloatNumerical assessment between 0 and 1 of the candidate’s seniority match.
seniority_match_score_categorystringCategorical description of the candidate’s seniority match score.
education_match_scorefloatNumerical assessment between 0 and 1 of the candidate’s education match.
education_match_score_categorystringCategorical description of the candidate’s education match score.

Skills Report

The skills report assesses the skill gaps and overlaps between the candidate and their target job or occupation. The skill taxonomy section includes additional information about skills and their associated metadata. The extent to which each skill is required by a destination job, and has been attained by a candidate (based on what is attested in their resume/profile or inferred from their experience), are both scored on a 0 to 1 scale.

FIELDTYPESHORT DESCRIPTION
skillstringSkill name
valuefloatNumerical assessment of the magnitude of overlap or gap. Larger values indicate more significant overlaps or gaps. If a specific skill is assessed as entirely relevant for a job (1.0/1.0) and mostly attained by a candidate (0.8/1.0), that skill would have an overlap of 0.8 and gap of 0.2.
overlap / gapstringIndicates if the skill is being highlighted in the Skill Report as an overlap or a gap.
categorystringCategorical description of the overlap or gap, based on value.
skill_clusterstringName of a group of similar skills. This can be used for organizing lists of skills.
skill_typestringIndicates if the skill is a specialized skill, baseline skill or certification.

Description of Skill Overlap / Gap Categories

CATEGORYFROMTODESCRIPTION
VERY LARGE0.751.0For skill overlaps: A candidate almost certainly possesses direct experience with the relevant skill.

For skill gaps: A candidate almost certainly lacks direct experience with, or adjacent and transferable skills to, the relevant skill.
LARGE0.5< 0.75For skill overlaps: A candidate likely possesses direct experience with, or adjacent and transferable skills to, the relevant skill.

For skill gaps: A candidate likely lacks direct experience with, or adjacent and transferable skills to, the relevant skill.
MEDIUM0.25< 0.5For skill overlaps: A candidate might possess limited direct experience with, or some adjacent and transferable skills to, the relevant skill, but is unlikely to be highly skilled.

For skill gaps: A candidate might lack direct experience with the relevant skill, but likely has adjacent and transferable skills.
SMALL0.0< 0.25For skill overlaps: A candidate is unlikely to possess any direct experience with, or adjacent and transferable skills to, the relevant skill, and is unlikely to be highly skilled.

For skill gaps: A candidate is unlikely to lack direct experience with the relevant skill, or is likely to have adjacent and transferable skills.

Match Narrative

The match narrative provides a Generative AI-created synopsis of the match and draws from the match score, the intermediate scores, and the skill gaps and overlaps. (Available in Beta)

FIELDTYPESHORT DESCRIPTION
narrativestringGenerative AI-created synopsis of match evaluation.

Match Example

{
	"candidates_scores": {
		"Piya Gupta": {
			"attribute_scores": {
				"history_score": 0.5355103611946106,
				"skills_score": 0.9592143893241882
			},
			"match_score": 0.7570914030075073,
			"match_score_category": "Medium",
			"narrative": "Piya Gupta is a medium quality match for the Marketing Associate role and is worth considering for the role depending on talent availability. They have transferable skills in Marketing, Communications, Writing, Social Media and Sales. However, they likely need upskilling in HubSpot CRM, Google Analytics, Marketing Automation, Social Media Strategy and Analytics if these are relevant to the role.",
			"skills report": {
				"gaps": [
					{
						"category": "Very Large",
						"name": "HubSpot CRM",
						"skill_category": "Customer Relationship Management (CRM)",
						"skill_type": "Specialized Skill",
						"value": 0.9000158309936523
					},
					{
						"category": "Very Large",
						"name": "Google Analytics",
						"skill_category": "Web Analytics and SEO",
						"skill_type": "Specialized Skill",
						"value": 0.8248963356018066
					},
					{
						"category": "Very Large",
						"name": "Marketing Automation",
						"skill_category": "Digital Marketing",
						"skill_type": "Specialized Skill",
						"value": 0.814994752407074
					},
					{
						"category": "Very Large",
						"name": "Social Media Strategy",
						"skill_category": "Social Media",
						"skill_type": "Specialized Skill",
						"value": 0.8044937252998352
					},
					{
						"category": "Very Large",
						"name": "Analytics",
						"skill_category": "Data Analysis",
						"skill_type": "Specialized Skill",
						"value": 0.7679097652435303
					}
				],
				"overlaps": [
					{
						"category": "Very Large",
						"name": "Marketing",
						"skill_category": "Marketing Strategy and Techniques",
						"skill_type": "Specialized Skill",
						"value": 1.0
					},
					{
						"category": "Very Large",
						"name": "Communications",
						"skill_category": "Communication",
						"skill_type": "Baseline Skill",
						"value": 1.0
					},
					{
						"category": "Very Large",
						"name": "Social Media",
						"skill_category": "Social Media",
						"skill_type": "Specialized Skill",
						"value": 1.0
					},
					{
						"category": "Very Large",
						"name": "Sales",
						"skill_category": "General Sales Practices",
						"skill_type": "Baseline Skill",
						"value": 1.0
					},
					{
						"category": "Very Large",
						"name": "Writing",
						"skill_category": "Writing and Editing",
						"skill_type": "Baseline Skill",
						"value": 1.0
					}
				]
			}
		}
	}