> ## Documentation Index > Fetch the complete documentation index at: https://agenticadvertisingorg-addie-wg-slack-context.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # report_plan_outcome > report_plan_outcome sends action results to the AdCP governance agent so it can update budget tracking, state, and compliance records. # report\_plan\_outcome **Experimental.** Campaign governance (`sync_plans`, `check_governance`, `report_plan_outcome`, `get_plan_audit_logs`) is part of AdCP 3.0 as an experimental surface — it may change between 3.x releases with at least 6 weeks' notice. Sellers implementing it MUST declare `governance.campaign` in `experimental_features`. See [experimental status](/dist/docs/3.1.24/reference/experimental-status) for the full contract. Report the outcome of an action to the governance agent. Called by the orchestrator (buyer-side agent) after a seller responds. This is the "after" half of the governance loop -- it tells the governance agent what actually happened so it can update its state and flag any issues. Sellers do not call this task. They report delivery data via [`check_governance`](./check_governance) with `phase: "delivery"`. ## Seller response (after `create_media_buy`) ```json theme={null} { "tool": "report_plan_outcome", "arguments": { "plan_id": "plan_q1_2026_launch", "check_id": "chk_xyz789", "governance_context": "gc_mb_seller_456", "outcome": "completed", "seller_response": { "seller_reference": "mb_seller_456", "packages": [ { "package_id": "pkg_001", "product_id": "premium_video_300k", "budget": 150000, "targeting_overlay": { "geo": { "include": [{ "type": "country", "code": "US" }] }, "viewability": { "standard": "mrc", "threshold": 50 } } } ], "planned_delivery": { "geo": { "countries": ["US"] }, "channels": ["olv"], "start_time": "2026-03-15T00:00:00Z", "end_time": "2026-06-15T00:00:00Z", "total_budget": 150000, "currency": "USD" }, "creative_deadline": "2026-03-20T00:00:00Z" } } } ``` ### Response (no issues) ```json theme={null} { "outcome_id": "out_001", "outcome_state": "accepted", "committed_budget": 150000, "plan_summary": { "total_committed": 425000, "budget_remaining": 75000 } } ``` The governance agent updates its state: budget is now committed based on the seller's confirmed amount, and the media buy is tracked. ### Response (discrepancy found) In this alternative scenario for the same action, the seller modified the request: ```json theme={null} { "outcome_id": "out_002", "outcome_state": "findings", "committed_budget": 120000, "findings": [ { "category_id": "seller_verification", "severity": "warning", "explanation": "Seller reduced budget from $150,000 to $120,000 and added geo targeting for CA that was not requested.", "details": { "discrepancies": [ { "field": "packages[0].budget", "requested": 150000, "received": 120000 }, { "field": "packages[0].targeting_overlay.geo.include", "requested": ["US"], "received": ["US", "CA"] } ] } } ], "plan_summary": { "total_committed": 395000, "budget_remaining": 105000 } } ``` The governance agent still commits the seller's actual amount (\$120K, not the requested \$150K) but returns findings for the orchestrator to act on. ## Delivery data (periodic reporting) ```json theme={null} { "tool": "report_plan_outcome", "arguments": { "plan_id": "plan_q1_2026_launch", "governance_context": "gc_mb_seller_456", "outcome": "delivery", "delivery": { "reporting_period": { "start": "2026-03-15T00:00:00Z", "end": "2026-03-22T00:00:00Z" }, "impressions": 1250000, "spend": 18750, "cpm": 15.00, "viewability_rate": 0.72, "completion_rate": 0.65 } } } ``` ### Response (on track) ```json theme={null} { "outcome_id": "out_del_001", "outcome_state": "accepted" } ``` ### Response (anomaly detected) ```json theme={null} { "outcome_id": "out_del_002", "outcome_state": "findings", "findings": [ { "category_id": "budget_authority", "severity": "warning", "explanation": "Spend is pacing 62% above plan. At current rate, budget will be exhausted 5 weeks early.", "details": { "planned_weekly_spend": 11538, "actual_weekly_spend": 18750, "overpace_pct": 62, "projected_exhaustion": "2026-05-03T00:00:00Z" } } ] } ``` ## Failed actions If the seller rejected the request, report it so the governance agent can update plan state: ```json theme={null} { "tool": "report_plan_outcome", "arguments": { "plan_id": "plan_q1_2026_launch", "check_id": "chk_xyz789", "governance_context": "gc_mb_seller_456", "outcome": "failed", "error": { "code": "PRODUCT_UNAVAILABLE", "message": "Product premium_video_300k is no longer available." } } } ``` ```json theme={null} { "outcome_id": "out_003", "outcome_state": "accepted", "committed_budget": 0, "plan_summary": { "total_committed": 275000, "budget_remaining": 225000 } } ``` ## Fields ### Request | Field | Type | Required | Description | | - | - | - | - | | `plan_id` | string | Yes | The plan this outcome is for. | | `check_id` | string | Conditional | The `check_id` from `check_governance`. Links the outcome to the governance check that authorized it. Required for `completed` and `failed` outcomes. | | `purchase_type` | enum | No | The kind of financial commitment: `media_buy` (default), `rights_license`, `signal_activation`, or `creative_services`. When omitted, the governance agent assumes `media_buy`. | | `outcome` | enum | Yes | `completed`, `failed`, or `delivery`. | | `seller_response` | object | No | The seller's full response. Required when outcome is `completed`. | | `seller_response.seller_reference` | string | No | The seller's identifier for the created resource (e.g., `media_buy_id`, `rights_grant_id`, `deployment_id`). Not interpreted by the governance agent — included in audit logs for human-readable traceability alongside the opaque `governance_context`. | | `seller_response.committed_budget` | number | No | Total budget committed across all confirmed packages. When present, the governance agent uses this directly instead of summing individual package budgets. | | `seller_response.packages` | array | No | Confirmed packages with actual budget and targeting. | | `seller_response.planned_delivery` | object | No | What the seller said it will deliver. When seller-side governance is not configured, this is the governance agent's only view of the seller's delivery parameters. | | `seller_response.creative_deadline` | string | No | ISO 8601 deadline for creative submission. | | `delivery` | object | No | Delivery metrics. Required when outcome is `delivery`. The `governance_context` (already required on all governance calls) is the sole lifecycle correlator. | | `delivery.reporting_period` | object | No | Start and end timestamps for the reporting window. | | `delivery.impressions` | integer | No | Impressions delivered in the period. | | `delivery.spend` | number | No | Spend in the period. | | `delivery.cpm` | number | No | Effective CPM for the period. | | `delivery.viewability_rate` | number | No | Viewability rate (0-1). | | `delivery.completion_rate` | number | No | Video completion rate (0-1). | | `error` | object | No | Error details. Required when outcome is `failed`. | | `error.code` | string | No | Error code from the seller. | | `error.message` | string | No | Human-readable error description. | ### Response | Field | Type | Description | | - | - | - | | `outcome_id` | string | Unique identifier for this outcome record. | | `outcome_state` | enum | `accepted` (state updated, no issues) or `findings` (issues detected). | | `committed_budget` | number | Budget committed from this outcome (present for `completed`/`failed` outcomes). | | `findings` | array | Present only when `outcome_state` is `findings`. | | `findings[].category_id` | string | Which validation category flagged the issue. | | `findings[].severity` | enum | `info`, `warning`, or `critical`. | | `findings[].explanation` | string | Human-readable description of the issue. | | `findings[].details` | object | Structured details for programmatic consumption. | | `plan_summary` | object | Updated plan budget state (present for `completed`/`failed` outcomes). | ## Error codes | Code | Recovery | Description | | - | - | - | | `PLAN_NOT_FOUND` | correctable | No plan with this ID, or the plan is not accessible to the calling account. | | `REFERENCE_NOT_FOUND` | correctable | `check_id` does not resolve to a governance check, or `governance_context` does not resolve to a campaign in the plan. `error.field` MUST identify which typed parameter failed to resolve. | | `CAMPAIGN_SUSPENDED` | correctable | Plan is suspended pending human review. Outcome reporting is blocked until the escalation is resolved. | ## Related tasks * [`check_governance`](./check_governance) -- The governance check that authorized the action * [`sync_plans`](./sync_plans) -- Push or update the plan * [`get_plan_audit_logs`](./get_plan_audit_logs) -- View plan state and audit trail This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.