Skip to main content
POST
/
media-buy-approvals
/
{mediaBuyId}
/
evaluate
Evaluate a media buy against acceptance policy
curl --request POST \
  --url https://api.interchange.io/api/v2/storefront/media-buy-approvals/{mediaBuyId}/evaluate \
  --header 'Authorization: Bearer <token>'
{
  "mediaBuyId": "<string>",
  "evaluatorId": "<string>",
  "evaluatorVersion": "<string>",
  "summary": "<string>",
  "checks": [
    {
      "label": "<string>",
      "detail": "<string>",
      "evaluator_id": "<string>",
      "evaluator_version": "<string>",
      "code": "<string>",
      "blocking": true,
      "confidence": 0.5,
      "evidence_refs": [
        "<string>"
      ],
      "remediation": "<string>"
    }
  ]
}

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. Media buys are only auto-approval eligible when definitely on policy; all other cases escalate.

Available options:
auto_approve,
escalate_to_human
​
summary
string
required

Short evaluator summary.

​
checks
object[]
required

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