---
title: "Evaluate routing rule"
method: POST
path: "/routing/evaluate"
tags: ["Routing Rules"]
---

# Evaluate routing rule

`POST /routing/evaluate`

Evaluate the active routing rule for a merchant against a payment context. Returns the ordered list of gateways selected by the rule without consuming SR data.

## Request body

- EvaluateRoutingRequest
  - `created_by` string, required — Merchant that owns the routing rule.
  - `payment_id` string, nullable
  - `fallback_output` ConnectorInfo[], nullable — Connectors to fall back to when no rule matches.
    - `gateway_name` string, required
    - `gateway_id` string, nullable
  - `parameters` object, required — Map of rule-builder key to typed value. A null value means the key is present but unset.

## Response `200`

Evaluation result with ordered gateway list

- RoutingEvaluateResponse
  - `payment_id` string, nullable
  - `status` string
  - `output` object — Raw output of the matched rule, tagged by algorithm type (`priority`, `single`, `volume_split`, `advanced`).
  - `evaluated_output` ConnectorInfo[]
    - `gateway_name` string, required
    - `gateway_id` string, nullable
  - `eligible_connectors` ConnectorInfo[]
    - `gateway_name` string, required
    - `gateway_id` string, nullable

---

[API](https://skmtc.net/juspay/apis/decision-engine.md) · [All operations](https://skmtc.net/juspay/apis/decision-engine/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/juspay/decision-engine/versions/36e7a0972ee6/schema)