---
title: "Evaluate an intent against policies"
method: POST
path: "/v1/intents/evaluate"
tags: ["intents"]
---

# Evaluate an intent against policies

`POST /v1/intents/evaluate`

Submits a proposed value-moving action for evaluation against the policy engine. Returns the verdict (PASS, DENY, or PENDING_APPROVAL), detailed per-policy results, and a cryptographic receipt hash. If PASS, the intent is auto-settled. If PENDING_APPROVAL, an approval request is queued for human review.

## Request body

- EvaluateIntentDto
  - `intentId` string, required — Unique intent identifier
  - `agent` string, required — Agent wallet address or identifier
  - `requester` string, required — Wallet funding this action
  - `recipient` string, required — Destination wallet for settlement
  - `amount` string, required — Amount in token base units (6 decimals for USDC)
  - `actionType` number, required — Action classification: 0=api_payment, 1=reward, 2=treasury
  - `mint` string — SPL token mint address

## Response `200`

Intent evaluated successfully

- object
  - `verdict` 'PASS' | 'DENY' | 'PENDING_APPROVAL'
  - `intentId` string
  - `id` string, uuid
  - `receiptHash` string
  - `amount` string
  - `status` string
  - `policyResults` object[]
    - `name` string
    - `verdict` string
    - `reason` string

## Other responses

- `400` — Invalid request body

---

[API](https://skmtc.dev/humbleaf/apis/agentchain-guard-api.md) · [All operations](https://skmtc.dev/humbleaf/apis/agentchain-guard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humbleaf/agentchain-guard-api/revisions/6670c57f15a3/schema)