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.

FIELD	TYPE	SHORT DESCRIPTION
`match_score`	`Float`	Numerical assessment between 0 and 1 of the match between a candidate and a job.
`match_score_category`	`String`	Categorical description of the match score.

Description of Match Score Categories

CATEGORY	FROM	TO	DESCRIPTION
VERY HIGH	0.9	1.0	Outstanding matches that warrant immediate action (an application, an interview, etc.). Typically ~20% of matches for large customers.
HIGH	0.8	<0.9	Good matches that warrant action (an application, an interview, etc.), with small and addressable gaps. Typically ~30% of matches for large customers.
MEDIUM	0.7	<0.8	Decent 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.
LOW	0.0	<0.7	Poor 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)

FIELD	TYPE	SHORT DESCRIPTION
`skill_match_score`	`float`	Numerical assessment between 0 and 1 of the candidate’s skills match.
`skill_match_score_category`	`string`	Categorical description of the candidate’s skill match score.
`work_experience_match_score`	`float`	Numerical assessment between 0 and 1 of the candidate’s work experience match.
`work_experience_match_score_category`	`string`	Categorical description of the candidate’s work experience match score.
`seniority_match_score`	`float`	Numerical assessment between 0 and 1 of the candidate’s seniority match.
`seniority_match_score_category`	`string`	Categorical description of the candidate’s seniority match score.
`education_match_score`	`float`	Numerical assessment between 0 and 1 of the candidate’s education match.
`education_match_score_category`	`string`	Categorical 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.

FIELD	TYPE	SHORT DESCRIPTION
`skill`	`string`	Skill name
`value`	`float`	Numerical 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 / gap`	`string`	Indicates if the skill is being highlighted in the Skill Report as an overlap or a gap.
`category`	`string`	Categorical description of the overlap or gap, based on `value`.
`skill_cluster`	`string`	Name of a group of similar skills. This can be used for organizing lists of skills.
`skill_type`	`string`	Indicates if the skill is a specialized skill, baseline skill or certification.

Description of Skill Overlap / Gap Categories

CATEGORY	FROM	TO	DESCRIPTION
VERY LARGE	0.75	1.0	For 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.
LARGE	0.5	< 0.75	For 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.
MEDIUM	0.25	< 0.5	For 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.
SMALL	0.0	< 0.25	For 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)

FIELD	TYPE	SHORT DESCRIPTION
`narrative`	`string`	Generative 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
					}
				]
			}
		}
	}