Skip to main content
GET
/
routing
/
evaluate
Error
A valid request URL is required to generate request examples
{
  "data": {
    "rule": {
      "id": "a1b2c3d4-5678-9012-abcd-ef0123456789",
      "name": "PI Auto Tort — California"
    },
    "assignments": [
      {
        "firmId": "f1a2b3c4-0000-1111-2222-333344445555",
        "firmName": "Smith & Associates",
        "referralInstructions": "Email intake@smithlaw.com with the signed retainer before referring."
      },
      {
        "firmId": "f2b3c4d5-1111-2222-3333-444455556666",
        "firmName": "Johnson Trial Group",
        "referralInstructions": null
      }
    ]
  },
  "meta": {
    "timestamp": "2026-04-22T12:00:00.000Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

Public API key (format cxp_<tier>_<body>, tier = ro|std|full). Scoped to a single firm. The firm must have public_api in allowedIntegrations.

Query Parameters

​
caseType
string
required

Case type name or ID to match against routing rule conditions

​
jurisdiction
string
required

Jurisdiction code (e.g. NY) to match against routing rule conditions

​
tier
integer

Routing tier to evaluate (optional)

​
county
string

County name to match against routing rule conditions (optional)

​
typeCategory
string

Case type category to match against routing rule conditions (optional)

​
attempt
integer
default:1

Routing attempt number (default 1)

Response

Matched routing rule with ordered firm assignments, or data: null if no rule matches

​
data
object
required

The result of evaluating routing rules against a case profile. Contains the single highest-priority rule that matched and an ordered array of all firm assignments configured on that rule. The first assignment is the highest-priority target firm. If no rule matches the given case profile, the entire data field is null (not an empty result object).

​
meta
object
required