---
sourceDocument: Xanadu Customer Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/customer-service-management

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Customer Service Management

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# Invoke the MatchingRuleProcessor API

# Invoke the MatchingRuleProcessor API {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

After you create one or more matching rules, you can invoke the MatchingRuleProcessor
API and run the rules.

## Before you begin

Role required: sn_customerservice_agent, sn_customerservice_manager, admin

## Procedure

* You can invoke the matching engine using the processAndGetCandidates method of the matchingRuleProcessor class.  
  Pass in the task record and the number of resources. The result is an array of resource sys_ids.
* The system processes the matching rules based on the number stored in the Execution Order field for each rule.  
  The result is a list of users (sys_ids), which you can use for case routing and assignment.
{#t_InvokeMatchingRuleAPI__steps-unordered_j5x_qmj_nsb}