---
title: "Evaluate Rules"
method: POST
path: "/api/v1/rules/evaluate"
tags: ["Budget Rules"]
---

# Evaluate Rules

`POST /api/v1/rules/evaluate`

## Request

- Base URL: `https://api.adrex.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.adrex.ai/api/v1/rules/evaluate`
- Auth: HTTP bearer

Evaluate enabled rules against campaign metrics.
Returns suggested actions without applying them.

## Request body

- EvaluateRulesRequest: Request to evaluate rules
  - `campaign_ids` string[], nullable
  - `days` integer

## Response `200`

Successful Response

- EvaluationResult: Result of evaluating rules for campaigns
  - `evaluated_at` string, date-time, required
  - `campaigns_evaluated` integer, required
  - `rules_checked` integer, required
  - `suggestions` SuggestedAction[], required
    - `campaign_id` string, required
    - `campaign_name` string, required
    - `platform` string, required
    - `account_id` string, nullable
    - `rule_template_id` string, required
    - `rule_name` string, required
    - `rule_icon` string, required
    - `action_type` 'increase_budget' | 'decrease_budget' | 'pause_campaign' | 'resume_campaign', required
    - `old_value` number, required
    - `new_value` number, required
    - `change_percent` number, required
    - `reason` string, required
    - `metric_values` object, required
    - `priority_score` number
  - `errors` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/adrex/apis/adrex-ai.md) · [All operations](https://skmtc.dev/adrex/apis/adrex-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/adrex/apis/adrex-ai/revisions/4e6f0f0bc902?raw)