What Are "Required Match Fields" in RChilli's Search and Match? – RChilli HelpDesk

Definition and Purpose

"Required Match Fields" in RChilli’s Search & Match API (v3.0) are specific attributes (like skills, location, experience) that are mandatory for consideration in a search or match query. These fields influence how the system filters, scores, and ranks results in candidate-to-job or job-to-candidate scenarios.

They serve two primary functions:

Precision Filtering – Ensures only candidates or jobs that meet essential requirements appear in results.
Weighted Scoring – Fields marked as "required" often carry higher weightage in the match score algorithm.

Examples of Common Required Fields

Typical fields that are frequently marked as required:

Skill – e.g., Java, Salesforce
JobProfile – e.g., Software Engineer
TotalExperienceRange / TotalExperienceInYear
Degree – educational qualifications
JobLocationCity, State, Country
IndustryType / Category, SubCategory
Organization / Employer

These are normalized via ontology and taxonomy APIs to ensure semantic matches (e.g., “Software Engineer” ≈ “Developer”).

How It Works

The requiredMatchFields parameter applies an AND condition to all included fields—meaning all must match for a document to qualify.
Fields not included in requiredMatchFields are evaluated with an OR condition and contribute optionally to the score.
If a required field is missing in a candidate or job, the system either:
- Excludes the record entirely
- Or assigns it a lower match score.

This configuration can be:

Embedded in the API payload
Managed through the RChilli MyAccount UI
Enhanced via Taxonomy APIs for broader skill/domain matching.

Sample JSON Usage

For Matching – JD to Resume:

"requiredMatchFields": [
  "JobProfile",
  "Organization",
  "Skill",
  "Degree",
  "TotalExperienceRange",
  "JobLocationCity",
  "JobLocationState",
  "JobLocationCountry",
  "IndustryType",
  "Domains"
]

For Matching – Resume to JD:

"requiredMatchFields": [
  "JobProfile",
  "Employer",
  "Skill",
  "Degree",
  "City",
  "State",
  "Country",
  "TotalExperienceInYear",
  "Category",
  "SubCategory"
]

For Simple Search (Resume IndexType):

"requiredMatchFields": [
  "JobProfile",
  "Employer",
  "Skill",
  "Degree",
  "City",
  "State",
  "Country",
  "TotalExperienceInYear"
]

For Simple Search (JD IndexType):

"requiredMatchFields": [

  "JobProfile",
  "Organization",
  "Skill",
  "Degree",
  "TotalExperienceRange",
  "JobLocationCity",
  "JobLocationState",
  "JobLocationCountry"
]

Error Handling

Error Code	Message
`2119`	`requiredMatchFields must be an array of string values`
`2120`	`required match fields {field name} not available`

Where to Configure

You can set required match fields in the following ways:

API Request Payload – By adding the requiredMatchFields array.
RChilli MyAccount UI – Through scoring and filter configuration tools.
Advanced Options – Via experience deviation settings, facet filtering, and dynamic scoring.

Useful Resources

Final Note

Using requiredMatchFields strategically helps refine search accuracy and prioritize relevance in candidate/job matching. For custom support, contact support@rchilli.com or explore configurations through MyAccount.