---
title: "Evaluates an enabled rule and returns the paged list of matching"
method: POST
path: "/commerce/rules/callOffOrder/{code}/evaluate"
tags: ["CallOffOrderRule"]
---

# Evaluates an enabled rule and returns the paged list of matching

`POST /commerce/rules/callOffOrder/{code}/evaluate`

Call-Off Order ids. Optionally AND-composes the rule expression with a
`statusFilter` to scope results to a single status.

## Path parameters

- `code` string, required

## Query parameters

- `responseFields` string

## Request body

- CallOffOrderRuleEvalRequest — Request body for `POST /commerce/rules/callOffOrder/{code}/evaluate`.
  - `pageSize` integer, nullable — Requested page size. Defaults to 50 when omitted. Values above 200 are silently clamped to 200 per FR-009.
  - `pageToken` string, nullable — Opaque cursor returned by a prior response's `NextPageToken`. Null on the first page.
  - `statusFilter` string, nullable — Optional Call-Off Order status (e.g. `"Hold"`) AND-composed with the rule predicate at evaluation time.

## Response `200`

OK

- CallOffOrderRuleEvalResponse — Response body for `POST /commerce/rules/callOffOrder/{code}/evaluate`.
  - `callOffOrderIds` string[], nullable — Matched Call-Off Order ids, up to `PageSize`, ordered by `_id` ascending.
  - `nextPageToken` string, nullable — Cursor for the next page; null when this is the last page.
  - `ruleCode` string, nullable — Echoed input rule code for client correlation.
  - `totalCount` integer — Total number of matching orders across all pages (not capped at `PageSize`).

## Other responses

- `404` — No enabled rule exists for the given code.

---

[API](https://skmtc.net/kibocommerce/apis/customer.md) · [All operations](https://skmtc.net/kibocommerce/apis/customer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kibocommerce/customer/versions/47c0cf7b75ab/schema)