---
title: "Evaluate a labelled synthetic sample in a verified AgentSaaS trial"
method: POST
path: "/aws/commerce/trial/evaluations"
---

# Evaluate a labelled synthetic sample in a verified AgentSaaS trial

`POST /aws/commerce/trial/evaluations`

## Request

- Base URL: `https://commerce.decionis.com`
- URL: `https://commerce.decionis.com/aws/commerce/trial/evaluations`
- Auth: HTTP bearer

Requires a source-verified active trial. The server generates a synthetic SHADOW proposal; callers cannot supply customer data, policy, organization, execution mode or transaction payloads. The actual Protocol decision is returned without promising a particular outcome. At most 10,000 unique evaluations are admitted across the 14-day trial. Replays reuse the same idempotency key and never consume an additional slot. Expiry and the cap stop new evaluations without paid overage or automatic paid conversion. This additive trial feature does not replace the paid governance APIs. Billing/trial activation is default-off until deployment validation.

## Headers

- `Idempotency-Key` string

## Request body

- AwsTrialEvaluationRequest
  - `sample` 'healthy' | 'below_cost', required
  - `idempotency_key` string, required

## Response `200`

Actual synthetic Shadow evaluation; not cacheable

- CommerceEvaluationResponse
  - `commerce_preflight` CommercePreflightResult
    - `version` 'commerce-preflight-v2', required
    - `action_type` 'PRICE_CHANGE' | 'INVENTORY_MUTATION' | 'ORDER_ACCEPTANCE' | 'FULFILLMENT_ACTION' | 'PROMOTION_CHANGE' | 'REFUND_REQUEST' | 'RETURN_AUTHORIZATION' | 'PAYMENT_RELEASE' | 'VENDOR_BANK_CHANGE' | 'EARLY_PAYMENT_DISCOUNT' | 'CREDIT_HOLD_RELEASE', required
    - `action_digest` string, required
    - `facts_digest` string, required
    - `policy_version` string, required
    - `idempotency_key` string, required
    - `evaluated_at` string, date-time, required
    - `disposition` 'PROCEED' | 'HOLD' | 'BLOCK', required
    - `execution_available` false, required
    - `checks` object[], required
      - `id` 'P01' | 'P02' | 'P03' | 'P04' | 'P05' | 'P06' | 'P07' | 'P08' | 'P09' | 'P10' | 'P11' | 'P12' | 'P13' | 'P14' | 'P15' | 'P16', required
      - `status` 'evaluated' | 'not_applicable' | 'disabled' | 'missing_facts' | 'unsupported', required
      - `verdict` 'PROCEED' | 'HOLD' | 'BLOCK', nullable, required
      - `reason_codes` string[], required
      - `missing_facts` string[], required
      - `measurements` object
  - `policy_evaluation` object
    - `commerce_preflight` CommercePreflightResult
      - `version` 'commerce-preflight-v2', required
      - `action_type` 'PRICE_CHANGE' | 'INVENTORY_MUTATION' | 'ORDER_ACCEPTANCE' | 'FULFILLMENT_ACTION' | 'PROMOTION_CHANGE' | 'REFUND_REQUEST' | 'RETURN_AUTHORIZATION' | 'PAYMENT_RELEASE' | 'VENDOR_BANK_CHANGE' | 'EARLY_PAYMENT_DISCOUNT' | 'CREDIT_HOLD_RELEASE', required
      - `action_digest` string, required
      - `facts_digest` string, required
      - `policy_version` string, required
      - `idempotency_key` string, required
      - `evaluated_at` string, date-time, required
      - `disposition` 'PROCEED' | 'HOLD' | 'BLOCK', required
      - `execution_available` false, required
      - `checks` object[], required
        - `id` 'P01' | 'P02' | 'P03' | 'P04' | 'P05' | 'P06' | 'P07' | 'P08' | 'P09' | 'P10' | 'P11' | 'P12' | 'P13' | 'P14' | 'P15' | 'P16', required
        - `status` 'evaluated' | 'not_applicable' | 'disabled' | 'missing_facts' | 'unsupported', required
        - `verdict` 'PROCEED' | 'HOLD' | 'BLOCK', nullable, required
        - `reason_codes` string[], required
        - `missing_facts` string[], required
        - `measurements` object
  - `mode` 'SHADOW', required
  - `outcome` 'APPROVE' | 'REJECT' | 'REVIEW' | 'ESCALATE', required
  - `confidence` number, required
  - `policy_version` string, required
  - `objective_profile` string, required
  - `dossier_id` string, uuid, required
  - `evaluation_id` string, uuid, required
  - `reason_codes` string[]
  - `fallback_to_legacy` boolean, required
  - `governance_metrics` CommerceGovernanceMetrics, required
    - `override_drift_rate` number, required
    - `governance_tension_index` number, required
    - `boundary_volatility_score` number, required
    - `decision_volume_under_governance` number, required
  - `idempotent_replay` boolean, required

## Other responses

- `400`: Stable, non-sensitive historical API error
- `401`: Stable, non-sensitive historical API error
- `402`: Trial evaluation allowance exhausted; no charge is created
- `403`: Stable, non-sensitive historical API error
- `409`: Stable, non-sensitive historical API error
- `429`: Stable, non-sensitive historical API error
- `503`: Stable, non-sensitive historical API error

---

[API](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/revisions/9fecb7109bf8?raw)