Skip to main content
POST
Evaluate a media buy against acceptance policy

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

mediaBuyId
string
required

Buyer-supplied media buy identifier (AdCP media_buy_id).

Minimum string length: 1

Response

Evaluate a media buy against acceptance policy

Policy evaluation for a storefront media-buy approval queue entry. This classifies whether the buy is auto-approval eligible or should escalate to a human.

mediaBuyId
string
required

Buyer-supplied media buy identifier that was evaluated.

evaluatorId
string
required

Stable evaluator implementation id.

evaluatorVersion
string
required

Evaluator implementation version.

policyDecision
enum<string>
required

definitely_on_policy means this buy is eligible for automatic approval. needs_human_approval is the safe escalation default. definitely_not_on_policy means the payload clearly conflicts with acceptance policy, but the recommended action can still be escalation rather than automatic rejection because the storefront may have already quoted the product.

Available options:
definitely_on_policy,
definitely_not_on_policy,
needs_human_approval
recommendation
enum<string>
required

Recommended workflow action. auto_approve = definitely on policy, eligible to forward without review. escalate_to_human = the safe default, queue for an operator. auto_reject = the buy clearly violates an explicit, deterministically-matched acceptance-policy rule (e.g. a category the operator wrote in unambiguous block language); it is decision-support only — the gate still queues these to a human unless an operator has opted a storefront into live auto-reject. LLM-judged conflicts never yield auto_reject; they escalate.

Available options:
auto_approve,
escalate_to_human,
auto_reject
rejectionReason
string | null
required

When recommendation is auto_reject, an evaluator-generated explanation naming the acceptance-policy terms the buy matched (drawn from the operator's policy). Null otherwise.

summary
string
required

Short evaluator summary.

checks
object[]
required

Individual policy, advertiser, and quoted-product checks supporting the recommendation.