---
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

## Changes

> 13 revisions in range; 1 could not be searched.

- **2026-08-04** `36e7a0972ee6` — 2 breaking, 2 warning, 7 info
  - added the new required request property `created_by`
  - added the new required request property `parameters`
  - removed the request property `merchantId`
  - removed the request property `paymentInfo`
  - …7 more
- **2026-04-25** `986e537b0455` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-04-10** `9618544de91a` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - the endpoint scheme security `BearerAuth` was removed from the API

[Change history](https://skmtc.dev/juspay/apis/decision-engine/changes/routing/evaluate/post.md)

---

[API](https://skmtc.dev/juspay/apis/decision-engine.md) · [All operations](https://skmtc.dev/juspay/apis/decision-engine/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/juspay/decision-engine/revisions/a35ceeb59faf/schema)