findBenchmarkMatches

Returns ranked benchmark-job candidates for the requested role. This tool is the best starting point when the goal is to identify likely benchmark matches before pricing or deeper role review.

Tool-specific notes

• A maximum of 5 candidates is returned.
• Each candidate includes its own match confidence, benchmark title, score, rationale, and benchmark-job attributes.
• Use this tool before getMarketRate or getBenchmarkJobDetails when the client wants to review multiple possible benchmark matches.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country code, e.g. 'USA'",
      "type": "string"
    },
    "jobTitle": {
      "description": "Job title of the internal role (provide at least one of jobTitle or jobDescription)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "jobDescription": {
      "description": "Free-text job description (optional, alternative or supplement to jobTitle)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "state": {
      "description": "State or province code (optional), e.g. 'CA', 'NY'",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "city": {
      "description": "City (optional), e.g. 'San Francisco'",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "zipCode": {
      "description": "ZIP or postal code (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "sessionId": {
      "description": "Session ID for conversation context (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
      "country"
  ]
}

Output Schema

{
  "data": {
    "datasetRoutedTo": "MarketData",
    "normalizedGeography": {
      "country": "USA",
      "region": "Northeast",
      "state": "MA",
      "city": "Boston"
    },
    "candidates": [
      {
        "matchRating": "Confident",
        "rank": 1,
        "benchmarkJobTitle": "Purchasing Clerk I",
        "score": 1,
        "rationaleNotes": "Purchasing Clerk I is the closest match due to similar responsibilities in processing purchase orders, maintaining records, and supporting procurement activities at the entry level.",
        "jobFamilyName": "Supply Chain & Distribution",
        "jobLevelName": "A01-Entry",
        "socCode": "43-3061",
        "socTitle": "Procurement Clerks",
        "jobSummary": "Initiates, prepares, processes, and verifies purchase orders following established guidelines to purchase materials and goods by required delivery dates.",
        "jobDescription": "Initiates, prepares, processes, and verifies purchase orders following established guidelines to purchase materials and goods by required delivery dates. Inputs transactions and administers a purchasing and contracts system or database. Interacts with suppliers to obtain favorable pricing terms, product specifications, monitor availability, and optimize savings. Expedites delayed orders and resolves issues with changes, returns, replacements, and credit arrangements. Coordinates with internal teams to ensure that procurement needs are met promptly and efficiently. Requires a high school diploma. Typically reports to a supervisor or team leader. Works under the close direction of senior personnel in the functional area. Possesses a moderate understanding of general aspects of the job. May require 0-1 year of general work experience.",
        "educationDegree": "High School",
        "experienceYearMin": 0,
        "experienceYearMax": 1,
        "skills": [
          "Contracts Management & Administration",
          "Data Entry-Keyboarding",
          "E-Procurement",
          "ERP Systems",
          "Expediting",
          "Inventory Control Software",
          "Inventory Management",
          "Legal-Contracts Review",
          "Order Processing",
          "Pricing Analysis",
          "Procurement Function",
          "Purchasing",
          "Purchasing Tasks and Activities",
          "Supplier Evaluations & Certification",
          "Supplier Management"
        ]
      },
      {
        "matchRating": "Confident",
        "rank": 2,
        "benchmarkJobTitle": "Purchasing Clerk II",
        "score": 0.9448,
        "rationaleNotes": "This role is the closest match due to similar responsibilities in processing purchase orders, maintaining records, and supporting procurement activities within the supply chain function.",
        "jobFamilyName": "Supply Chain & Distribution",
        "jobLevelName": "A02-Intermediate",
        "socCode": "43-3061",
        "socTitle": "Procurement Clerks",
        "jobSummary": "Initiates, prepares, processes, and verifies purchase orders following established guidelines to purchase materials and goods by required delivery dates.",
        "jobDescription": "Initiates, prepares, processes, and verifies purchase orders following established guidelines to purchase materials and goods by required delivery dates. Inputs transactions and administers a purchasing and contracts system or database. Interacts with suppliers to obtain favorable pricing terms, product specifications, monitor availability, and optimize savings. Expedites delayed orders and resolves issues with changes, returns, replacements, and credit arrangements. Coordinates with internal teams to ensure that procurement needs are met promptly and efficiently. Requires a high school diploma. Typically reports to a supervisor or team leader. Works under moderate supervision. Gaining or has attained full proficiency in a specific area of discipline. Typically requires 1-3 years of related experience.",
        "educationDegree": "High School",
        "experienceYearMin": 1,
        "experienceYearMax": 3,
        "skills": [
          "Contracts Management & Administration",
          "Data Entry-Keyboarding",
          "E-Procurement",
          "ERP Systems",
          "Expediting",
          "Inventory Control Software",
          "Inventory Management",
          "Legal-Contracts Review",
          "Order Processing",
          "Pricing Analysis",
          "Procurement Function",
          "Purchasing",
          "Purchasing Tasks and Activities",
          "Supplier Evaluations & Certification",
          "Supplier Management"
        ]
      },
      {
        "matchRating": "NeedsReview",
        "rank": 3,
        "benchmarkJobTitle": "Purchasing Clerk III",
        "score": 0.6548,
        "rationaleNotes": "This role is a closest match due to similar responsibilities in processing purchase orders and maintaining supplier records, though the benchmark may include additional duties such as complex procurement tasks or vendor negotiations.",
        "jobFamilyName": "Supply Chain & Distribution",
        "jobLevelName": "A03-Senior",
        "socCode": "43-3061",
        "socTitle": "Procurement Clerks",
        "jobSummary": "Initiates, prepares, processes, and verifies purchase orders following established guidelines to purchase materials and goods by required delivery dates.",
        "jobDescription": "Initiates, prepares, processes, and verifies purchase orders following established guidelines to purchase materials and goods by required delivery dates. Inputs transactions and administers a purchasing and contracts system or database. Interacts with suppliers to obtain favorable pricing terms, product specifications, monitor availability, and optimize savings. Expedites delayed orders and resolves issues with changes, returns, replacements, and credit arrangements. Coordinates with internal teams to ensure that procurement needs are met promptly and efficiently. Requires a high school diploma. Typically reports to a supervisor or team leader. Works independently within established procedures associated with the specific job function. Has gained proficiency in multiple competencies relevant to the job. Typically requires 3-5 years of related experience.",
        "educationDegree": "High School",
        "experienceYearMin": 3,
        "experienceYearMax": 5,
        "skills": [
          "Data Entry-Keyboarding",
          "ERP Systems",
          "Expediting",
          "Inventory Control Software",
          "Inventory Management",
          "Order Processing",
          "Pricing Analysis",
          "Purchasing",
          "Supplier Management"
        ]
      }
    ],
    "summaryText": "The top-ranked benchmark, \"Purchasing Clerk I,\" is a confident match — purchasing Clerk I is the closest match due to similar responsibilities in processing purchase orders, maintaining records, and supporting procurement activities at the entry level. In contrast, the second-ranked candidate, \"Purchasing Clerk II,\" represents this role is the closest match due to similar responsibilities in processing purchase orders, maintaining records, and supporting procurement activities within the supply chain function and carries a confident match.",
    "executionId": "exec_1779960587497_7ab4c95728bc4965ba067d31bc33ef60"
  },
  "nextActions": [
    "Get market rate for a selected benchmark → getMarketRate"
  ]
}