@adcp/sdk 5.23.0

package/dist/lib/schemas-data/3.0.1/bundled/media-buy/get-media-buys-response.json

@@ -0,0 +1,2357 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/bundled/media-buy/get-media-buys-response.json",
+  "title": "Get Media Buys Response",
+  "description": "Response payload for get_media_buys task. Returns media buy configuration, creative approval state, and optional delivery snapshots.",
+  "type": "object",
+  "properties": {
+    "media_buys": {
+      "type": "array",
+      "description": "Array of media buys with status, creative approval state, and optional delivery snapshots",
+      "items": {
+        "type": "object",
+        "properties": {
+          "media_buy_id": {
+            "type": "string",
+            "description": "Seller's unique identifier for the media buy",
+            "x-entity": "media_buy"
+          },
+          "account": {
+            "title": "Account",
+            "description": "Account billed for this media buy",
+            "type": "object",
+            "properties": {
+              "account_id": {
+                "type": "string",
+                "description": "Unique identifier for this account",
+                "x-entity": "account"
+              },
+              "name": {
+                "type": "string",
+                "description": "Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')"
+              },
+              "advertiser": {
+                "type": "string",
+                "description": "The advertiser whose rates apply to this account"
+              },
+              "billing_proxy": {
+                "type": "string",
+                "description": "Optional intermediary who receives invoices on behalf of the advertiser (e.g., agency)"
+              },
+              "status": {
+                "title": "Account Status",
+                "description": "Account lifecycle status. See the Accounts Protocol overview for the operations matrix showing which tasks are permitted in each state.",
+                "type": "string",
+                "enum": [
+                  "active",
+                  "pending_approval",
+                  "rejected",
+                  "payment_required",
+                  "suspended",
+                  "closed"
+                ],
+                "enumDescriptions": {
+                  "active": "Account is operational and can create media buys",
+                  "pending_approval": "Seller is reviewing the account (credit, contracts)",
+                  "rejected": "Seller declined the account request — terminal state",
+                  "payment_required": "Credit limit reached or funds depleted",
+                  "suspended": "Was active, now paused — operations gated",
+                  "closed": "Was active, now terminated — terminal state"
+                }
+              },
+              "brand": {
+                "title": "Brand Reference",
+                "description": "Brand reference identifying the advertiser",
+                "type": "object",
+                "properties": {
+                  "domain": {
+                    "type": "string",
+                    "description": "Domain where /.well-known/brand.json is hosted, or the brand's operating domain",
+                    "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
+                  },
+                  "brand_id": {
+                    "title": "Brand ID",
+                    "description": "Brand identifier within the house portfolio. Optional for single-brand domains.",
+                    "type": "string",
+                    "pattern": "^[a-z0-9_]+$",
+                    "x-entity": "advertiser_brand",
+                    "examples": [
+                      "tide",
+                      "cheerios",
+                      "air_jordan",
+                      "nike",
+                      "pampers"
+                    ]
+                  },
+                  "industries": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."
+                  },
+                  "data_subject_contestation": {
+                    "type": "object",
+                    "description": "Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.",
+                    "properties": {
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "pattern": "^https://"
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email"
+                      },
+                      "languages": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "anyOf": [
+                      {
+                        "required": [
+                          "url"
+                        ]
+                      },
+                      {
+                        "required": [
+                          "email"
+                        ]
+                      }
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "domain"
+                ],
+                "additionalProperties": false,
+                "examples": [
+                  {
+                    "domain": "nova-brands.com",
+                    "brand_id": "spark"
+                  },
+                  {
+                    "domain": "nova-brands.com",
+                    "brand_id": "glow"
+                  },
+                  {
+                    "domain": "acme-corp.com"
+                  }
+                ]
+              },
+              "operator": {
+                "type": "string",
+                "description": "Domain of the entity operating this account. When the brand operates directly, this is the brand's domain.",
+                "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$",
+                "x-entity": "operator"
+              },
+              "billing": {
+                "title": "Billing Party",
+                "description": "Who is invoiced on this account. See billing_entity for the invoiced party's business details.",
+                "type": "string",
+                "enum": [
+                  "operator",
+                  "agent",
+                  "advertiser"
+                ],
+                "enumDescriptions": {
+                  "operator": "Seller invoices the operator — agency or brand buying direct",
+                  "agent": "Agent consolidates billing across brands and is invoiced by the seller",
+                  "advertiser": "Seller invoices the advertiser directly, even when a different operator places orders on their behalf"
+                }
+              },
+              "billing_entity": {
+                "title": "Business Entity",
+                "description": "Business entity details for the party responsible for payment. Contains the legal name, tax IDs, address, and bank details needed for formal B2B invoicing. Corresponds to whoever billing points to (operator, agent, or advertiser). When this account appears in a response, bank details MUST be omitted (write-only).",
+                "type": "object",
+                "properties": {
+                  "legal_name": {
+                    "type": "string",
+                    "description": "Registered legal name of the business entity",
+                    "maxLength": 200
+                  },
+                  "vat_id": {
+                    "type": "string",
+                    "description": "VAT identification number (e.g., DE123456789 for Germany, FR12345678901 for France). Required for B2B invoicing in the EU. Must be normalized: no spaces, dots, or dashes.",
+                    "pattern": "^[A-Z]{2}[A-Z0-9]{2,13}$"
+                  },
+                  "tax_id": {
+                    "type": "string",
+                    "description": "Tax identification number for jurisdictions that do not use VAT (e.g., US EIN)",
+                    "maxLength": 30
+                  },
+                  "registration_number": {
+                    "type": "string",
+                    "description": "Company registration number (e.g., HRB 12345 for German Handelsregister)",
+                    "maxLength": 50
+                  },
+                  "address": {
+                    "type": "object",
+                    "description": "Postal address for invoicing and legal correspondence",
+                    "properties": {
+                      "street": {
+                        "type": "string",
+                        "description": "Street address including building number",
+                        "maxLength": 200
+                      },
+                      "city": {
+                        "type": "string",
+                        "maxLength": 100
+                      },
+                      "postal_code": {
+                        "type": "string",
+                        "maxLength": 20
+                      },
+                      "region": {
+                        "type": "string",
+                        "description": "State, province, or region",
+                        "maxLength": 100
+                      },
+                      "country": {
+                        "type": "string",
+                        "description": "ISO 3166-1 alpha-2 country code",
+                        "pattern": "^[A-Z]{2}$"
+                      }
+                    },
+                    "required": [
+                      "street",
+                      "city",
+                      "postal_code",
+                      "country"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "contacts": {
+                    "type": "array",
+                    "description": "Contacts for billing, legal, and operational matters. Contains personal data subject to GDPR and equivalent regulations. Implementations MUST use this data only for invoicing and account management.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "role": {
+                          "type": "string",
+                          "enum": [
+                            "billing",
+                            "legal",
+                            "creative",
+                            "general"
+                          ],
+                          "enumDescriptions": {
+                            "billing": "Accounts payable and invoice queries",
+                            "legal": "Contract and compliance matters",
+                            "creative": "Material submission and creative approval",
+                            "general": "Default contact when no specific role applies"
+                          },
+                          "description": "Contact's functional role in the business relationship"
+                        },
+                        "name": {
+                          "type": "string",
+                          "description": "Full name of the contact",
+                          "maxLength": 200
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "maxLength": 254
+                        },
+                        "phone": {
+                          "type": "string",
+                          "maxLength": 30
+                        }
+                      },
+                      "required": [
+                        "role"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "maxItems": 10
+                  },
+                  "bank": {
+                    "type": "object",
+                    "writeOnly": true,
+                    "description": "Bank account details for payment processing. Write-only: included in requests to provide payment coordinates, but MUST NOT be echoed in responses. Sellers store these details and confirm receipt without returning them.",
+                    "properties": {
+                      "account_holder": {
+                        "type": "string",
+                        "description": "Name on the bank account",
+                        "maxLength": 200
+                      },
+                      "iban": {
+                        "type": "string",
+                        "description": "International Bank Account Number (SEPA markets)",
+                        "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{4,30}$"
+                      },
+                      "bic": {
+                        "type": "string",
+                        "description": "Bank Identifier Code / SWIFT code (SEPA markets)",
+                        "pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
+                      },
+                      "routing_number": {
+                        "type": "string",
+                        "description": "Bank routing number for non-SEPA markets (e.g., US ABA routing number, Canadian transit/institution number)",
+                        "maxLength": 30
+                      },
+                      "account_number": {
+                        "type": "string",
+                        "description": "Bank account number for non-SEPA markets",
+                        "maxLength": 30
+                      }
+                    },
+                    "required": [
+                      "account_holder"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "ext": {
+                    "title": "Extension Object",
+                    "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                    "type": "object",
+                    "additionalProperties": true
+                  }
+                },
+                "required": [
+                  "legal_name"
+                ],
+                "additionalProperties": false,
+                "examples": [
+                  {
+                    "description": "German agency with full B2B details",
+                    "data": {
+                      "legal_name": "Pinnacle Media GmbH",
+                      "vat_id": "DE123456789",
+                      "registration_number": "HRB 12345",
+                      "address": {
+                        "street": "Friedrichstrasse 100",
+                        "city": "Berlin",
+                        "postal_code": "10117",
+                        "country": "DE"
+                      },
+                      "contacts": [
+                        {
+                          "role": "billing",
+                          "name": "Sam Adeyemi",
+                          "email": "billing@pinnacle-media.com",
+                          "phone": "+49 30 12345678"
+                        }
+                      ],
+                      "bank": {
+                        "account_holder": "Pinnacle Media GmbH",
+                        "iban": "DE89370400440532013000",
+                        "bic": "COBADEFFXXX"
+                      }
+                    }
+                  },
+                  {
+                    "description": "US advertiser with EIN and domestic bank details",
+                    "data": {
+                      "legal_name": "Acme Corporation",
+                      "tax_id": "12-3456789",
+                      "address": {
+                        "street": "123 Main St",
+                        "city": "New York",
+                        "postal_code": "10001",
+                        "region": "NY",
+                        "country": "US"
+                      },
+                      "contacts": [
+                        {
+                          "role": "billing",
+                          "name": "AP Department",
+                          "email": "ap@acme-corp.com"
+                        }
+                      ],
+                      "bank": {
+                        "account_holder": "Acme Corporation",
+                        "routing_number": "021000021",
+                        "account_number": "123456789"
+                      }
+                    }
+                  }
+                ]
+              },
+              "rate_card": {
+                "type": "string",
+                "description": "Identifier for the rate card applied to this account"
+              },
+              "payment_terms": {
+                "title": "Payment Terms",
+                "description": "Payment terms agreed for this account. Binding for all invoices when the account is active.",
+                "type": "string",
+                "enum": [
+                  "net_15",
+                  "net_30",
+                  "net_45",
+                  "net_60",
+                  "net_90",
+                  "prepay"
+                ],
+                "enumDescriptions": {
+                  "net_15": "Payment due within 15 days of invoice",
+                  "net_30": "Payment due within 30 days of invoice",
+                  "net_45": "Payment due within 45 days of invoice",
+                  "net_60": "Payment due within 60 days of invoice",
+                  "net_90": "Payment due within 90 days of invoice",
+                  "prepay": "Payment required before campaign delivery"
+                }
+              },
+              "credit_limit": {
+                "type": "object",
+                "description": "Maximum outstanding balance allowed",
+                "properties": {
+                  "amount": {
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "currency": {
+                    "type": "string",
+                    "pattern": "^[A-Z]{3}$"
+                  }
+                },
+                "required": [
+                  "amount",
+                  "currency"
+                ]
+              },
+              "setup": {
+                "type": "object",
+                "description": "Present when status is 'pending_approval'. Contains next steps for completing account activation.",
+                "properties": {
+                  "url": {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "URL where the human can complete the required action (credit application, legal agreement, add funds)."
+                  },
+                  "message": {
+                    "type": "string",
+                    "description": "Human-readable description of what's needed."
+                  },
+                  "expires_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "When this setup link expires."
+                  }
+                },
+                "required": [
+                  "message"
+                ],
+                "additionalProperties": true
+              },
+              "account_scope": {
+                "title": "Account Scope",
+                "description": "How the seller scoped a billing account relative to the operator and brand dimensions.",
+                "type": "string",
+                "enum": [
+                  "operator",
+                  "brand",
+                  "operator_brand",
+                  "agent"
+                ],
+                "enumDescriptions": {
+                  "operator": "Account is shared across all brands for this operator",
+                  "brand": "Account is shared across all operators for this brand",
+                  "operator_brand": "Account is dedicated to a specific operator+brand combination",
+                  "agent": "The agent's default account with no brand or operator association"
+                }
+              },
+              "governance_agents": {
+                "type": "array",
+                "description": "Governance agent endpoints registered on this account. Authentication credentials are write-only and not included in responses — use sync_governance to set or update credentials.",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "url": {
+                      "type": "string",
+                      "format": "uri",
+                      "pattern": "^https://",
+                      "description": "Governance agent endpoint URL. Must use HTTPS."
+                    },
+                    "categories": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "maxLength": 64,
+                        "pattern": "^[a-z][a-z0-9_]*$"
+                      },
+                      "description": "Governance categories this agent handles (e.g., ['budget_authority', 'strategic_alignment']). When omitted, the agent handles all categories.",
+                      "maxItems": 20
+                    }
+                  },
+                  "required": [
+                    "url"
+                  ],
+                  "additionalProperties": false
+                },
+                "maxItems": 10
+              },
+              "reporting_bucket": {
+                "type": "object",
+                "description": "Cloud storage bucket where the seller delivers offline reporting files for this account. Seller provisions a dedicated bucket or a per-account prefix within a shared bucket, and grants the buyer read access out-of-band. Access MUST be scoped at the IAM layer so each account can only read its own prefix — bucket-wide grants are non-compliant even with per-account prefixes. Seller MUST revoke access when the account's status transitions to inactive, suspended, or closed. See security considerations for offline delivery in docs/media-buy/media-buys/optimization-reporting. Only present when the seller supports offline delivery (reporting_delivery_methods includes 'offline' in capabilities).",
+                "properties": {
+                  "protocol": {
+                    "title": "Cloud Storage Protocol",
+                    "description": "Cloud storage protocol",
+                    "type": "string",
+                    "enum": [
+                      "s3",
+                      "gcs",
+                      "azure_blob"
+                    ]
+                  },
+                  "bucket": {
+                    "type": "string",
+                    "description": "Bucket or container name",
+                    "minLength": 3,
+                    "maxLength": 63,
+                    "pattern": "^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$"
+                  },
+                  "prefix": {
+                    "type": "string",
+                    "description": "Path prefix within the bucket. Seller appends date-based partitioning beneath this prefix.",
+                    "maxLength": 512,
+                    "pattern": "^[a-zA-Z0-9/_.-]+$",
+                    "examples": [
+                      "accounts/pinnacle/adcp",
+                      "reporting/2024"
+                    ]
+                  },
+                  "region": {
+                    "type": "string",
+                    "description": "Cloud region for the bucket",
+                    "maxLength": 64,
+                    "pattern": "^[a-z0-9-]+$",
+                    "examples": [
+                      "us-east-1",
+                      "europe-west1"
+                    ]
+                  },
+                  "format": {
+                    "type": "string",
+                    "enum": [
+                      "jsonl",
+                      "csv",
+                      "parquet",
+                      "avro",
+                      "orc"
+                    ],
+                    "description": "File format for delivered files. Parquet, Avro, and ORC use internal compression (the top-level compression field is ignored for these formats).",
+                    "default": "jsonl"
+                  },
+                  "compression": {
+                    "type": "string",
+                    "enum": [
+                      "gzip",
+                      "none"
+                    ],
+                    "description": "Compression applied to delivered files",
+                    "default": "gzip"
+                  },
+                  "file_retention_days": {
+                    "type": "integer",
+                    "description": "How long reporting files are retained in the bucket before deletion. Buyers must read files within this window. Minimum recommended: 14 days.",
+                    "minimum": 1,
+                    "examples": [
+                      14,
+                      30,
+                      90
+                    ]
+                  },
+                  "setup_instructions": {
+                    "type": "string",
+                    "format": "uri",
+                    "pattern": "^https://",
+                    "description": "URL to documentation for configuring buyer read access to this bucket (IAM role, service account, etc.). Operator-facing documentation — buyer agents MUST NOT auto-fetch this URL; surface it to a human operator. If an implementation fetches it (for preview), apply webhook URL SSRF validation and do not pass the fetched content into an LLM context without indirect-prompt-injection guarding. See docs/media-buy/media-buys/optimization-reporting#security-considerations-for-offline-delivery."
+                  }
+                },
+                "required": [
+                  "protocol",
+                  "bucket",
+                  "file_retention_days"
+                ],
+                "additionalProperties": false
+              },
+              "sandbox": {
+                "type": "boolean",
+                "description": "When true, this is a sandbox account — no real platform calls, no real spend. For explicit accounts (require_operator_auth: true), sandbox accounts are pre-existing test accounts on the platform discovered via list_accounts. For implicit accounts, sandbox is part of the natural key: the same brand/operator pair can have both a production and sandbox account."
+              },
+              "ext": {
+                "title": "Extension Object",
+                "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                "type": "object",
+                "additionalProperties": true
+              }
+            },
+            "required": [
+              "account_id",
+              "name",
+              "status"
+            ],
+            "additionalProperties": true,
+            "examples": [
+              {
+                "description": "Direct advertiser account",
+                "data": {
+                  "account_id": "acc_acme_direct",
+                  "name": "Acme",
+                  "advertiser": "Acme Corp",
+                  "brand": {
+                    "domain": "acme-corp.com"
+                  },
+                  "operator": "acme-corp.com",
+                  "status": "active",
+                  "billing": "operator",
+                  "account_scope": "brand",
+                  "rate_card": "acme_vip_2024",
+                  "payment_terms": "net_30"
+                }
+              },
+              {
+                "description": "Advertiser account with agency billing proxy",
+                "data": {
+                  "account_id": "acc_acme_pinnacle",
+                  "name": "Acme c/o Pinnacle",
+                  "advertiser": "Acme Corp",
+                  "billing_proxy": "Pinnacle Media",
+                  "brand": {
+                    "domain": "acme-corp.com"
+                  },
+                  "operator": "pinnacle-media.com",
+                  "status": "active",
+                  "billing": "operator",
+                  "account_scope": "operator_brand",
+                  "rate_card": "acme_vip_2024",
+                  "payment_terms": "net_60"
+                }
+              },
+              {
+                "description": "Agency as direct buyer",
+                "data": {
+                  "account_id": "acc_pinnacle",
+                  "name": "Pinnacle",
+                  "advertiser": "Pinnacle Media",
+                  "brand": {
+                    "domain": "pinnacle-media.com"
+                  },
+                  "operator": "pinnacle-media.com",
+                  "status": "active",
+                  "billing": "operator",
+                  "account_scope": "operator",
+                  "rate_card": "agency_standard",
+                  "payment_terms": "net_45"
+                }
+              },
+              {
+                "description": "Account with brand identity and operator (via sync_accounts)",
+                "data": {
+                  "account_id": "acc_spark_001",
+                  "name": "Spark (via Pinnacle)",
+                  "advertiser": "Nova Brands",
+                  "status": "active",
+                  "brand": {
+                    "domain": "nova-brands.com",
+                    "brand_id": "spark"
+                  },
+                  "operator": "pinnacle-media.com",
+                  "billing": "agent",
+                  "account_scope": "operator_brand",
+                  "payment_terms": "net_30"
+                }
+              },
+              {
+                "description": "Pending account awaiting seller approval",
+                "data": {
+                  "account_id": "acc_glow_pending",
+                  "name": "Glow",
+                  "advertiser": "Nova Brands",
+                  "status": "pending_approval",
+                  "brand": {
+                    "domain": "nova-brands.com",
+                    "brand_id": "glow"
+                  },
+                  "operator": "pinnacle-media.com",
+                  "billing": "operator",
+                  "account_scope": "brand"
+                }
+              },
+              {
+                "description": "Agency operates but advertiser is billed directly with structured billing entity",
+                "data": {
+                  "account_id": "acc_acme_direct_bill",
+                  "name": "Acme (billed direct)",
+                  "advertiser": "Acme Corp",
+                  "brand": {
+                    "domain": "acme-corp.com"
+                  },
+                  "operator": "pinnacle-media.com",
+                  "status": "active",
+                  "billing": "advertiser",
+                  "billing_entity": {
+                    "legal_name": "Acme Corporation GmbH",
+                    "vat_id": "DE987654321",
+                    "address": {
+                      "street": "Hauptstrasse 42",
+                      "city": "Munich",
+                      "postal_code": "80331",
+                      "country": "DE"
+                    },
+                    "contacts": [
+                      {
+                        "role": "billing",
+                        "name": "AP Department",
+                        "email": "billing@acme-corp.com"
+                      }
+                    ]
+                  },
+                  "account_scope": "operator_brand",
+                  "payment_terms": "net_30"
+                }
+              }
+            ]
+          },
+          "invoice_recipient": {
+            "title": "Business Entity",
+            "description": "Per-buy invoice recipient when provided at creation. Confirms the seller accepted the billing override. Bank details are omitted (write-only).",
+            "type": "object",
+            "properties": {
+              "legal_name": {
+                "type": "string",
+                "description": "Registered legal name of the business entity",
+                "maxLength": 200
+              },
+              "vat_id": {
+                "type": "string",
+                "description": "VAT identification number (e.g., DE123456789 for Germany, FR12345678901 for France). Required for B2B invoicing in the EU. Must be normalized: no spaces, dots, or dashes.",
+                "pattern": "^[A-Z]{2}[A-Z0-9]{2,13}$"
+              },
+              "tax_id": {
+                "type": "string",
+                "description": "Tax identification number for jurisdictions that do not use VAT (e.g., US EIN)",
+                "maxLength": 30
+              },
+              "registration_number": {
+                "type": "string",
+                "description": "Company registration number (e.g., HRB 12345 for German Handelsregister)",
+                "maxLength": 50
+              },
+              "address": {
+                "type": "object",
+                "description": "Postal address for invoicing and legal correspondence",
+                "properties": {
+                  "street": {
+                    "type": "string",
+                    "description": "Street address including building number",
+                    "maxLength": 200
+                  },
+                  "city": {
+                    "type": "string",
+                    "maxLength": 100
+                  },
+                  "postal_code": {
+                    "type": "string",
+                    "maxLength": 20
+                  },
+                  "region": {
+                    "type": "string",
+                    "description": "State, province, or region",
+                    "maxLength": 100
+                  },
+                  "country": {
+                    "type": "string",
+                    "description": "ISO 3166-1 alpha-2 country code",
+                    "pattern": "^[A-Z]{2}$"
+                  }
+                },
+                "required": [
+                  "street",
+                  "city",
+                  "postal_code",
+                  "country"
+                ],
+                "additionalProperties": false
+              },
+              "contacts": {
+                "type": "array",
+                "description": "Contacts for billing, legal, and operational matters. Contains personal data subject to GDPR and equivalent regulations. Implementations MUST use this data only for invoicing and account management.",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "role": {
+                      "type": "string",
+                      "enum": [
+                        "billing",
+                        "legal",
+                        "creative",
+                        "general"
+                      ],
+                      "enumDescriptions": {
+                        "billing": "Accounts payable and invoice queries",
+                        "legal": "Contract and compliance matters",
+                        "creative": "Material submission and creative approval",
+                        "general": "Default contact when no specific role applies"
+                      },
+                      "description": "Contact's functional role in the business relationship"
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "Full name of the contact",
+                      "maxLength": 200
+                    },
+                    "email": {
+                      "type": "string",
+                      "format": "email",
+                      "maxLength": 254
+                    },
+                    "phone": {
+                      "type": "string",
+                      "maxLength": 30
+                    }
+                  },
+                  "required": [
+                    "role"
+                  ],
+                  "additionalProperties": false
+                },
+                "maxItems": 10
+              },
+              "bank": {
+                "type": "object",
+                "writeOnly": true,
+                "description": "Bank account details for payment processing. Write-only: included in requests to provide payment coordinates, but MUST NOT be echoed in responses. Sellers store these details and confirm receipt without returning them.",
+                "properties": {
+                  "account_holder": {
+                    "type": "string",
+                    "description": "Name on the bank account",
+                    "maxLength": 200
+                  },
+                  "iban": {
+                    "type": "string",
+                    "description": "International Bank Account Number (SEPA markets)",
+                    "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{4,30}$"
+                  },
+                  "bic": {
+                    "type": "string",
+                    "description": "Bank Identifier Code / SWIFT code (SEPA markets)",
+                    "pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
+                  },
+                  "routing_number": {
+                    "type": "string",
+                    "description": "Bank routing number for non-SEPA markets (e.g., US ABA routing number, Canadian transit/institution number)",
+                    "maxLength": 30
+                  },
+                  "account_number": {
+                    "type": "string",
+                    "description": "Bank account number for non-SEPA markets",
+                    "maxLength": 30
+                  }
+                },
+                "required": [
+                  "account_holder"
+                ],
+                "additionalProperties": false
+              },
+              "ext": {
+                "title": "Extension Object",
+                "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                "type": "object",
+                "additionalProperties": true
+              }
+            },
+            "required": [
+              "legal_name"
+            ],
+            "additionalProperties": false,
+            "examples": [
+              {
+                "description": "German agency with full B2B details",
+                "data": {
+                  "legal_name": "Pinnacle Media GmbH",
+                  "vat_id": "DE123456789",
+                  "registration_number": "HRB 12345",
+                  "address": {
+                    "street": "Friedrichstrasse 100",
+                    "city": "Berlin",
+                    "postal_code": "10117",
+                    "country": "DE"
+                  },
+                  "contacts": [
+                    {
+                      "role": "billing",
+                      "name": "Sam Adeyemi",
+                      "email": "billing@pinnacle-media.com",
+                      "phone": "+49 30 12345678"
+                    }
+                  ],
+                  "bank": {
+                    "account_holder": "Pinnacle Media GmbH",
+                    "iban": "DE89370400440532013000",
+                    "bic": "COBADEFFXXX"
+                  }
+                }
+              },
+              {
+                "description": "US advertiser with EIN and domestic bank details",
+                "data": {
+                  "legal_name": "Acme Corporation",
+                  "tax_id": "12-3456789",
+                  "address": {
+                    "street": "123 Main St",
+                    "city": "New York",
+                    "postal_code": "10001",
+                    "region": "NY",
+                    "country": "US"
+                  },
+                  "contacts": [
+                    {
+                      "role": "billing",
+                      "name": "AP Department",
+                      "email": "ap@acme-corp.com"
+                    }
+                  ],
+                  "bank": {
+                    "account_holder": "Acme Corporation",
+                    "routing_number": "021000021",
+                    "account_number": "123456789"
+                  }
+                }
+              }
+            ]
+          },
+          "status": {
+            "title": "Media Buy Status",
+            "description": "Status of a media buy.",
+            "type": "string",
+            "enum": [
+              "pending_creatives",
+              "pending_start",
+              "active",
+              "paused",
+              "completed",
+              "rejected",
+              "canceled"
+            ],
+            "enumDescriptions": {
+              "pending_creatives": "Media buy is approved but has no creatives assigned. The buyer must attach creatives via sync_creatives before the buy can serve.",
+              "pending_start": "Media buy is ready to serve and waiting for its flight date to begin.",
+              "active": "Media buy is currently running",
+              "paused": "Media buy is temporarily paused",
+              "completed": "Media buy has finished running",
+              "rejected": "Media buy was declined by the seller after creation",
+              "canceled": "Media buy was terminated before natural completion. Check cancellation.canceled_by to determine whether the buyer or seller initiated."
+            }
+          },
+          "currency": {
+            "type": "string",
+            "description": "ISO 4217 currency code (e.g., USD, EUR, GBP) for monetary values at this media buy level. total_budget is always denominated in this currency. Package-level fields may override with package.currency.",
+            "pattern": "^[A-Z]{3}$"
+          },
+          "total_budget": {
+            "type": "number",
+            "description": "Total budget amount across all packages, denominated in media_buy.currency",
+            "minimum": 0
+          },
+          "start_time": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO 8601 flight start time for this media buy (earliest package start_time). Avoids requiring buyers to compute min(packages[].start_time)."
+          },
+          "end_time": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO 8601 flight end time for this media buy (latest package end_time). Avoids requiring buyers to compute max(packages[].end_time)."
+          },
+          "creative_deadline": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO 8601 timestamp for creative upload deadline"
+          },
+          "confirmed_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO 8601 timestamp when the seller confirmed this media buy. A successful create_media_buy response constitutes order confirmation."
+          },
+          "cancellation": {
+            "type": "object",
+            "description": "Cancellation metadata. Present only when status is 'canceled'.",
+            "required": [
+              "canceled_at",
+              "canceled_by"
+            ],
+            "properties": {
+              "canceled_at": {
+                "type": "string",
+                "format": "date-time",
+                "description": "ISO 8601 timestamp when this media buy was canceled."
+              },
+              "canceled_by": {
+                "$ref": "#/$defs/CanceledBy"
+              },
+              "reason": {
+                "type": "string",
+                "description": "Reason the media buy was canceled.",
+                "maxLength": 500
+              }
+            },
+            "additionalProperties": false
+          },
+          "revision": {
+            "type": "integer",
+            "description": "Current revision number. Pass this in update_media_buy for optimistic concurrency.",
+            "minimum": 1
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Creation timestamp"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Last update timestamp"
+          },
+          "valid_actions": {
+            "type": "array",
+            "description": "Actions the buyer can perform on this media buy in its current state. Eliminates the need for agents to internalize the state machine — the seller declares what is permitted right now.",
+            "items": {
+              "title": "Media Buy Valid Action",
+              "description": "Actions the buyer can perform on a media buy",
+              "type": "string",
+              "enum": [
+                "pause",
+                "resume",
+                "cancel",
+                "update_budget",
+                "update_dates",
+                "update_packages",
+                "add_packages",
+                "sync_creatives"
+              ]
+            }
+          },
+          "history": {
+            "type": "array",
+            "description": "Revision history entries, most recent first. Only present when include_history > 0 in the request. Each entry represents a state change or update to the media buy. Entries are append-only: sellers MUST NOT modify or delete previously emitted history entries. Callers MAY cache entries by revision number. Returns min(N, available entries) when include_history exceeds the total.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "revision": {
+                  "type": "integer",
+                  "description": "Revision number after this change was applied.",
+                  "minimum": 1
+                },
+                "timestamp": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "When this change occurred."
+                },
+                "actor": {
+                  "type": "string",
+                  "description": "Identity of who made the change — derived from authentication context, not caller-provided. Format is seller-defined (e.g., agent URL, user email, API key label)."
+                },
+                "action": {
+                  "type": "string",
+                  "description": "What happened. Standard actions: created, activated, paused, resumed, canceled, rejected, completed, updated_budget, updated_dates, updated_packages, package_canceled, package_paused, package_resumed. Sellers MAY use additional platform-specific actions (e.g., creative_approved, targeting_updated) — use ext on the history entry for structured metadata about custom actions."
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "Human-readable summary of the change (e.g., 'Budget increased from $5,000 to $7,500 on pkg_abc').",
+                  "maxLength": 500
+                },
+                "package_id": {
+                  "type": "string",
+                  "description": "Package affected, when the change targeted a specific package.",
+                  "x-entity": "package"
+                },
+                "ext": {
+                  "title": "Extension Object",
+                  "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              },
+              "required": [
+                "revision",
+                "timestamp",
+                "action"
+              ],
+              "additionalProperties": true
+            }
+          },
+          "packages": {
+            "type": "array",
+            "description": "Packages within this media buy, augmented with creative approval status and optional delivery snapshots",
+            "items": {
+              "title": "PackageStatus",
+              "description": "Current status of a package within a media buy — includes creative approval state and optional delivery snapshot. For the creation input shape, see PackageRequest. For the creation output shape, see Package.",
+              "type": "object",
+              "properties": {
+                "package_id": {
+                  "type": "string",
+                  "description": "Seller's package identifier",
+                  "x-entity": "package"
+                },
+                "product_id": {
+                  "type": "string",
+                  "description": "Product identifier this package is purchased from",
+                  "x-entity": "product"
+                },
+                "budget": {
+                  "type": "number",
+                  "description": "Package budget amount, denominated in package.currency when present, otherwise media_buy.currency",
+                  "minimum": 0
+                },
+                "currency": {
+                  "type": "string",
+                  "description": "ISO 4217 currency code for monetary values at this package level (budget, bid_price, snapshot.spend). When absent, inherit media_buy.currency.",
+                  "pattern": "^[A-Z]{3}$"
+                },
+                "bid_price": {
+                  "type": "number",
+                  "description": "Current bid price for auction-based packages. Denominated in package.currency when present, otherwise media_buy.currency. Relevant for automated price optimization loops.",
+                  "minimum": 0
+                },
+                "impressions": {
+                  "type": "number",
+                  "description": "Goal impression count for impression-based packages",
+                  "minimum": 0
+                },
+                "targeting_overlay": {
+                  "title": "Targeting Overlay",
+                  "description": "Targeting overlay applied to this package, echoed from the most recent create_media_buy or update_media_buy. Sellers SHOULD echo any persisted targeting so buyers can verify what was stored without replaying their own request. Sellers claiming the property-lists or collection-lists specialisms MUST include, within this targeting_overlay, the PropertyListReference / CollectionListReference they persisted.",
+                  "type": "object",
+                  "properties": {
+                    "geo_countries": {
+                      "type": "array",
+                      "description": "Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').",
+                      "items": {
+                        "type": "string",
+                        "pattern": "^[A-Z]{2}$"
+                      },
+                      "minItems": 1
+                    },
+                    "geo_countries_exclude": {
+                      "type": "array",
+                      "description": "Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').",
+                      "items": {
+                        "type": "string",
+                        "pattern": "^[A-Z]{2}$"
+                      },
+                      "minItems": 1
+                    },
+                    "geo_regions": {
+                      "type": "array",
+                      "description": "Restrict delivery to specific regions/states. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').",
+                      "items": {
+                        "type": "string",
+                        "pattern": "^[A-Z]{2}-[A-Z0-9]{1,3}$"
+                      },
+                      "minItems": 1
+                    },
+                    "geo_regions_exclude": {
+                      "type": "array",
+                      "description": "Exclude specific regions/states from delivery. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').",
+                      "items": {
+                        "type": "string",
+                        "pattern": "^[A-Z]{2}-[A-Z0-9]{1,3}$"
+                      },
+                      "minItems": 1
+                    },
+                    "geo_metros": {
+                      "type": "array",
+                      "description": "Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "system": {
+                            "$ref": "#/$defs/MetroAreaSystem"
+                          },
+                          "values": {
+                            "type": "array",
+                            "description": "Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)",
+                            "items": {
+                              "type": "string"
+                            },
+                            "minItems": 1
+                          }
+                        },
+                        "required": [
+                          "system",
+                          "values"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 1
+                    },
+                    "geo_metros_exclude": {
+                      "type": "array",
+                      "description": "Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "system": {
+                            "$ref": "#/$defs/MetroAreaSystem"
+                          },
+                          "values": {
+                            "type": "array",
+                            "description": "Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)",
+                            "items": {
+                              "type": "string"
+                            },
+                            "minItems": 1
+                          }
+                        },
+                        "required": [
+                          "system",
+                          "values"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 1
+                    },
+                    "geo_postal_areas": {
+                      "type": "array",
+                      "description": "Restrict delivery to specific postal areas. Each entry specifies the postal system and target values. Seller must declare supported systems in get_adcp_capabilities.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "system": {
+                            "$ref": "#/$defs/PostalCodeSystem"
+                          },
+                          "values": {
+                            "type": "array",
+                            "description": "Postal codes within the system (e.g., ['10001', '10002'] for us_zip)",
+                            "items": {
+                              "type": "string"
+                            },
+                            "minItems": 1
+                          }
+                        },
+                        "required": [
+                          "system",
+                          "values"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 1
+                    },
+                    "geo_postal_areas_exclude": {
+                      "type": "array",
+                      "description": "Exclude specific postal areas from delivery. Each entry specifies the postal system and excluded values. Seller must declare supported systems in get_adcp_capabilities.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "system": {
+                            "$ref": "#/$defs/PostalCodeSystem"
+                          },
+                          "values": {
+                            "type": "array",
+                            "description": "Postal codes to exclude within the system (e.g., ['10001', '10002'] for us_zip)",
+                            "items": {
+                              "type": "string"
+                            },
+                            "minItems": 1
+                          }
+                        },
+                        "required": [
+                          "system",
+                          "values"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 1
+                    },
+                    "daypart_targets": {
+                      "type": "array",
+                      "description": "Restrict delivery to specific time windows. Each entry specifies days of week and an hour range.",
+                      "items": {
+                        "title": "Daypart Target",
+                        "description": "A time window for daypart targeting. Specifies days of week and an hour range. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.",
+                        "type": "object",
+                        "properties": {
+                          "days": {
+                            "type": "array",
+                            "description": "Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).",
+                            "items": {
+                              "title": "Day of Week",
+                              "description": "Days of the week for daypart targeting",
+                              "type": "string",
+                              "enum": [
+                                "monday",
+                                "tuesday",
+                                "wednesday",
+                                "thursday",
+                                "friday",
+                                "saturday",
+                                "sunday"
+                              ]
+                            },
+                            "minItems": 1
+                          },
+                          "start_hour": {
+                            "type": "integer",
+                            "description": "Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.",
+                            "minimum": 0,
+                            "maximum": 23
+                          },
+                          "end_hour": {
+                            "type": "integer",
+                            "description": "End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.",
+                            "minimum": 1,
+                            "maximum": 24
+                          },
+                          "label": {
+                            "type": "string",
+                            "description": "Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')"
+                          }
+                        },
+                        "required": [
+                          "days",
+                          "start_hour",
+                          "end_hour"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 1
+                    },
+                    "axe_include_segment": {
+                      "type": "string",
+                      "description": "Deprecated: Use TMP provider fields instead. AXE segment ID to include for targeting.",
+                      "deprecated": true
+                    },
+                    "axe_exclude_segment": {
+                      "type": "string",
+                      "description": "Deprecated: Use TMP provider fields instead. AXE segment ID to exclude from targeting.",
+                      "deprecated": true
+                    },
+                    "audience_include": {
+                      "type": "array",
+                      "description": "Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.",
+                      "items": {
+                        "type": "string"
+                      },
+                      "minItems": 1
+                    },
+                    "audience_exclude": {
+                      "type": "array",
+                      "description": "Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.",
+                      "items": {
+                        "type": "string"
+                      },
+                      "minItems": 1
+                    },
+                    "frequency_cap": {
+                      "title": "Frequency Cap",
+                      "description": "Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set.",
+                      "type": "object",
+                      "properties": {
+                        "suppress": {
+                          "allOf": [
+                            {
+                              "title": "Duration",
+                              "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+                              "type": "object",
+                              "properties": {
+                                "interval": {
+                                  "type": "integer",
+                                  "minimum": 1,
+                                  "description": "Number of time units. Must be 1 when unit is 'campaign'."
+                                },
+                                "unit": {
+                                  "type": "string",
+                                  "enum": [
+                                    "seconds",
+                                    "minutes",
+                                    "hours",
+                                    "days",
+                                    "campaign"
+                                  ],
+                                  "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+                                }
+                              },
+                              "required": [
+                                "interval",
+                                "unit"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ],
+                          "description": "Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {\"interval\": 60, \"unit\": \"minutes\"} for a 1-hour cooldown). Preferred over suppress_minutes."
+                        },
+                        "suppress_minutes": {
+                          "type": "number",
+                          "description": "Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).",
+                          "minimum": 0
+                        },
+                        "max_impressions": {
+                          "type": "integer",
+                          "description": "Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window; 'campaign' applies a fixed cap across the full flight.",
+                          "minimum": 1
+                        },
+                        "per": {
+                          "allOf": [
+                            {
+                              "title": "Reach Unit",
+                              "description": "Unit of measurement for reach and audience size metrics. Different channels and measurement providers count reach in fundamentally different units, making cross-channel comparison impossible without declaring the unit.",
+                              "type": "string",
+                              "enum": [
+                                "individuals",
+                                "households",
+                                "devices",
+                                "accounts",
+                                "cookies",
+                                "custom"
+                              ],
+                              "enumDescriptions": {
+                                "individuals": "Unique people. Panel-based or identity-resolved measurement.",
+                                "households": "Unique households or TV homes.",
+                                "devices": "Unique device identifiers (IDFA, GAID, CTV device ID).",
+                                "accounts": "Unique logged-in accounts (platform-specific identity).",
+                                "cookies": "Unique browser cookies.",
+                                "custom": "Publisher-defined reach unit. Describe in ext."
+                              }
+                            }
+                          ],
+                          "description": "Entity granularity for impression counting. Required when max_impressions is set."
+                        },
+                        "window": {
+                          "allOf": [
+                            {
+                              "title": "Duration",
+                              "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+                              "type": "object",
+                              "properties": {
+                                "interval": {
+                                  "type": "integer",
+                                  "minimum": 1,
+                                  "description": "Number of time units. Must be 1 when unit is 'campaign'."
+                                },
+                                "unit": {
+                                  "type": "string",
+                                  "enum": [
+                                    "seconds",
+                                    "minutes",
+                                    "hours",
+                                    "days",
+                                    "campaign"
+                                  ],
+                                  "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+                                }
+                              },
+                              "required": [
+                                "interval",
+                                "unit"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ],
+                          "description": "Time window for the max_impressions cap (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Required when max_impressions is set."
+                        }
+                      },
+                      "anyOf": [
+                        {
+                          "required": [
+                            "suppress"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "suppress_minutes"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "max_impressions"
+                          ]
+                        }
+                      ],
+                      "dependencies": {
+                        "max_impressions": [
+                          "per",
+                          "window"
+                        ],
+                        "per": [
+                          "max_impressions"
+                        ],
+                        "window": [
+                          "max_impressions"
+                        ]
+                      },
+                      "additionalProperties": true
+                    },
+                    "property_list": {
+                      "title": "Property List Reference",
+                      "description": "Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false.",
+                      "type": "object",
+                      "properties": {
+                        "agent_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "description": "URL of the agent managing the property list"
+                        },
+                        "list_id": {
+                          "type": "string",
+                          "description": "Identifier for the property list within the agent",
+                          "minLength": 1,
+                          "x-entity": "property_list"
+                        },
+                        "auth_token": {
+                          "type": "string",
+                          "description": "JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+                        }
+                      },
+                      "required": [
+                        "agent_url",
+                        "list_id"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "collection_list": {
+                      "title": "Collection List Reference",
+                      "description": "Reference to a collection list for including specific collections (programs, shows) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities.",
+                      "type": "object",
+                      "properties": {
+                        "agent_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "description": "URL of the agent managing the collection list"
+                        },
+                        "list_id": {
+                          "type": "string",
+                          "description": "Identifier for the collection list within the agent",
+                          "minLength": 1,
+                          "x-entity": "collection_list"
+                        },
+                        "auth_token": {
+                          "type": "string",
+                          "description": "JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+                        }
+                      },
+                      "required": [
+                        "agent_url",
+                        "list_id"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "collection_list_exclude": {
+                      "title": "Collection List Reference",
+                      "description": "Reference to a collection list for excluding specific collections (programs, shows) from this product. Matched collections must not carry the buyer's ads. Use for brand safety do-not-air lists. Seller must declare support in get_adcp_capabilities.",
+                      "type": "object",
+                      "properties": {
+                        "agent_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "description": "URL of the agent managing the collection list"
+                        },
+                        "list_id": {
+                          "type": "string",
+                          "description": "Identifier for the collection list within the agent",
+                          "minLength": 1,
+                          "x-entity": "collection_list"
+                        },
+                        "auth_token": {
+                          "type": "string",
+                          "description": "JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+                        }
+                      },
+                      "required": [
+                        "agent_url",
+                        "list_id"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "age_restriction": {
+                      "type": "object",
+                      "description": "Age restriction for compliance. Use for legal requirements (alcohol, gambling), not audience targeting.",
+                      "properties": {
+                        "min": {
+                          "type": "integer",
+                          "minimum": 13,
+                          "maximum": 99,
+                          "description": "Minimum age required"
+                        },
+                        "verification_required": {
+                          "type": "boolean",
+                          "default": false,
+                          "description": "Whether verified age (not inferred) is required for compliance"
+                        },
+                        "accepted_methods": {
+                          "type": "array",
+                          "description": "Accepted verification methods. If omitted, any method the platform supports is acceptable.",
+                          "items": {
+                            "title": "Age Verification Method",
+                            "description": "Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.",
+                            "type": "string",
+                            "enum": [
+                              "facial_age_estimation",
+                              "id_document",
+                              "digital_id",
+                              "credit_card",
+                              "world_id"
+                            ]
+                          },
+                          "minItems": 1
+                        }
+                      },
+                      "required": [
+                        "min"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "device_platform": {
+                      "type": "array",
+                      "description": "Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.",
+                      "items": {
+                        "title": "Device Platform",
+                        "description": "Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.",
+                        "type": "string",
+                        "enum": [
+                          "ios",
+                          "android",
+                          "windows",
+                          "macos",
+                          "linux",
+                          "chromeos",
+                          "tvos",
+                          "tizen",
+                          "webos",
+                          "fire_os",
+                          "roku_os",
+                          "unknown"
+                        ]
+                      },
+                      "minItems": 1
+                    },
+                    "device_type": {
+                      "type": "array",
+                      "description": "Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).",
+                      "items": {
+                        "$ref": "#/$defs/DeviceType"
+                      },
+                      "minItems": 1
+                    },
+                    "device_type_exclude": {
+                      "type": "array",
+                      "description": "Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).",
+                      "items": {
+                        "$ref": "#/$defs/DeviceType"
+                      },
+                      "minItems": 1
+                    },
+                    "store_catchments": {
+                      "type": "array",
+                      "description": "Target users within store catchment areas from a synced store catalog. Each entry references a store-type catalog and optionally narrows to specific stores or catchment zones.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "catalog_id": {
+                            "type": "string",
+                            "description": "Synced store-type catalog ID from sync_catalogs."
+                          },
+                          "store_ids": {
+                            "type": "array",
+                            "description": "Filter to specific stores within the catalog. Omit to target all stores.",
+                            "items": {
+                              "type": "string"
+                            },
+                            "minItems": 1
+                          },
+                          "catchment_ids": {
+                            "type": "array",
+                            "description": "Catchment zone IDs to target (e.g., 'walk', 'drive'). Omit to target all catchment zones.",
+                            "items": {
+                              "type": "string"
+                            },
+                            "minItems": 1
+                          }
+                        },
+                        "required": [
+                          "catalog_id"
+                        ],
+                        "additionalProperties": true
+                      },
+                      "minItems": 1
+                    },
+                    "geo_proximity": {
+                      "type": "array",
+                      "description": "Target users within travel time, distance, or a custom boundary around arbitrary geographic points. Multiple entries use OR semantics — a user within range of any listed point is eligible. For campaigns targeting 10+ locations, consider using store_catchments with a location catalog instead. Seller must declare support in get_adcp_capabilities.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "lat": {
+                            "type": "number",
+                            "minimum": -90,
+                            "maximum": 90,
+                            "description": "Latitude in decimal degrees (WGS 84). Required for travel_time and radius methods."
+                          },
+                          "lng": {
+                            "type": "number",
+                            "minimum": -180,
+                            "maximum": 180,
+                            "description": "Longitude in decimal degrees (WGS 84). Required for travel_time and radius methods."
+                          },
+                          "label": {
+                            "type": "string",
+                            "description": "Human-readable label for this entry (e.g., 'Düsseldorf', 'Heathrow Airport', 'Primary trade area')."
+                          },
+                          "travel_time": {
+                            "type": "object",
+                            "description": "Travel time limit for isochrone calculation. The platform resolves this to a geographic boundary based on actual transportation networks.",
+                            "properties": {
+                              "value": {
+                                "type": "number",
+                                "minimum": 1,
+                                "description": "Travel time limit."
+                              },
+                              "unit": {
+                                "title": "Travel Time Unit",
+                                "description": "Time unit for isochrone (travel-time catchment) calculations.",
+                                "type": "string",
+                                "enum": [
+                                  "min",
+                                  "hr"
+                                ],
+                                "enumDescriptions": {
+                                  "min": "Minutes",
+                                  "hr": "Hours"
+                                }
+                              }
+                            },
+                            "required": [
+                              "value",
+                              "unit"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "transport_mode": {
+                            "title": "Transport Mode",
+                            "description": "Transportation mode for isochrone calculation. Required when travel_time is provided.",
+                            "type": "string",
+                            "enum": [
+                              "walking",
+                              "cycling",
+                              "driving",
+                              "public_transport"
+                            ],
+                            "enumDescriptions": {
+                              "walking": "Pedestrian travel on walkable paths and sidewalks",
+                              "cycling": "Bicycle travel on roads and cycle paths",
+                              "driving": "Motor vehicle travel on road networks",
+                              "public_transport": "Public transit including bus, rail, metro, and ferry"
+                            }
+                          },
+                          "radius": {
+                            "type": "object",
+                            "description": "Simple radius from the point. The platform draws a circle of this distance around the coordinates.",
+                            "properties": {
+                              "value": {
+                                "type": "number",
+                                "exclusiveMinimum": 0,
+                                "description": "Radius distance."
+                              },
+                              "unit": {
+                                "title": "Distance Unit",
+                                "description": "Distance unit.",
+                                "type": "string",
+                                "enum": [
+                                  "km",
+                                  "mi",
+                                  "m"
+                                ],
+                                "enumDescriptions": {
+                                  "km": "Kilometers",
+                                  "mi": "Miles",
+                                  "m": "Meters"
+                                }
+                              }
+                            },
+                            "required": [
+                              "value",
+                              "unit"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "geometry": {
+                            "type": "object",
+                            "description": "Pre-computed GeoJSON geometry defining the proximity boundary. Use when the buyer has already calculated isochrones (via TravelTime, Mapbox, etc.) or has custom boundaries. When geometry is provided, lat/lng are not required.",
+                            "properties": {
+                              "type": {
+                                "type": "string",
+                                "enum": [
+                                  "Polygon",
+                                  "MultiPolygon"
+                                ],
+                                "description": "GeoJSON geometry type."
+                              },
+                              "coordinates": {
+                                "type": "array",
+                                "description": "GeoJSON coordinates array. For Polygon: array of linear rings. For MultiPolygon: array of polygons."
+                              }
+                            },
+                            "required": [
+                              "type",
+                              "coordinates"
+                            ],
+                            "additionalProperties": false
+                          },
+                          "ext": {
+                            "title": "Extension Object",
+                            "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                            "type": "object",
+                            "additionalProperties": true
+                          }
+                        },
+                        "oneOf": [
+                          {
+                            "required": [
+                              "lat",
+                              "lng",
+                              "travel_time",
+                              "transport_mode"
+                            ],
+                            "not": {
+                              "anyOf": [
+                                {
+                                  "required": [
+                                    "radius"
+                                  ]
+                                },
+                                {
+                                  "required": [
+                                    "geometry"
+                                  ]
+                                }
+                              ]
+                            }
+                          },
+                          {
+                            "required": [
+                              "lat",
+                              "lng",
+                              "radius"
+                            ],
+                            "not": {
+                              "anyOf": [
+                                {
+                                  "required": [
+                                    "travel_time"
+                                  ]
+                                },
+                                {
+                                  "required": [
+                                    "geometry"
+                                  ]
+                                }
+                              ]
+                            }
+                          },
+                          {
+                            "required": [
+                              "geometry"
+                            ],
+                            "not": {
+                              "anyOf": [
+                                {
+                                  "required": [
+                                    "travel_time"
+                                  ]
+                                },
+                                {
+                                  "required": [
+                                    "radius"
+                                  ]
+                                }
+                              ]
+                            }
+                          }
+                        ],
+                        "additionalProperties": true
+                      },
+                      "minItems": 1
+                    },
+                    "language": {
+                      "type": "array",
+                      "description": "Restrict to users with specific language preferences. ISO 639-1 codes (e.g., 'en', 'es', 'fr').",
+                      "items": {
+                        "type": "string",
+                        "pattern": "^[a-z]{2}$"
+                      },
+                      "minItems": 1
+                    },
+                    "keyword_targets": {
+                      "type": "array",
+                      "description": "Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "keyword": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "The keyword to target"
+                          },
+                          "match_type": {
+                            "$ref": "#/$defs/MatchType"
+                          },
+                          "bid_price": {
+                            "type": "number",
+                            "minimum": 0,
+                            "description": "Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."
+                          }
+                        },
+                        "required": [
+                          "keyword",
+                          "match_type"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 1
+                    },
+                    "negative_keywords": {
+                      "type": "array",
+                      "description": "Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "keyword": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "The keyword to exclude"
+                          },
+                          "match_type": {
+                            "$ref": "#/$defs/MatchType"
+                          }
+                        },
+                        "required": [
+                          "keyword",
+                          "match_type"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "minItems": 1
+                    }
+                  },
+                  "additionalProperties": true
+                },
+                "start_time": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "ISO 8601 flight start time for this package. Use to determine whether the package is within its scheduled flight before interpreting delivery status."
+                },
+                "end_time": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "ISO 8601 flight end time for this package"
+                },
+                "paused": {
+                  "type": "boolean",
+                  "description": "Whether this package is currently paused by the buyer"
+                },
+                "canceled": {
+                  "type": "boolean",
+                  "description": "Whether this package has been canceled. Canceled packages stop delivery and cannot be reactivated."
+                },
+                "cancellation": {
+                  "type": "object",
+                  "description": "Cancellation metadata. Present only when canceled is true.",
+                  "required": [
+                    "canceled_at",
+                    "canceled_by"
+                  ],
+                  "properties": {
+                    "canceled_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "ISO 8601 timestamp when this package was canceled."
+                    },
+                    "canceled_by": {
+                      "$ref": "#/$defs/CanceledBy"
+                    },
+                    "reason": {
+                      "type": "string",
+                      "description": "Reason the package was canceled.",
+                      "maxLength": 500
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "creative_deadline": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "ISO 8601 timestamp for creative upload or change deadline for this package. After this deadline, creative changes are rejected. When absent, the media buy's creative_deadline applies."
+                },
+                "creative_approvals": {
+                  "type": "array",
+                  "description": "Approval status for each creative assigned to this package. Absent when no creatives have been assigned.",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "creative_id": {
+                        "type": "string",
+                        "description": "Creative identifier",
+                        "x-entity": "creative"
+                      },
+                      "approval_status": {
+                        "title": "Creative Approval Status",
+                        "description": "Approval state of a creative on a specific package",
+                        "type": "string",
+                        "enum": [
+                          "pending_review",
+                          "approved",
+                          "rejected"
+                        ],
+                        "enumDescriptions": {
+                          "pending_review": "Creative has been submitted and is awaiting platform review",
+                          "approved": "Creative has been approved and is eligible for delivery",
+                          "rejected": "Creative was rejected by the platform, including change requests; see rejection_reason for required fixes and re-upload via sync_creatives"
+                        }
+                      },
+                      "rejection_reason": {
+                        "type": "string",
+                        "description": "Human-readable explanation of why the creative was rejected. Present only when approval_status is 'rejected'."
+                      }
+                    },
+                    "required": [
+                      "creative_id",
+                      "approval_status"
+                    ],
+                    "additionalProperties": true
+                  }
+                },
+                "format_ids_pending": {
+                  "type": "array",
+                  "description": "Format IDs from the original create_media_buy format_ids_to_provide that have not yet been uploaded via sync_creatives. When empty or absent, all required formats have been provided.",
+                  "items": {
+                    "title": "Format Reference (Structured Object)",
+                    "description": "A JSON object — never a plain string — that identifies a creative format by its declaring agent and local slug. Required properties: agent_url (URI of the agent that owns the format) and id (slug matching [a-zA-Z0-9_-]+). Example: {\"agent_url\": \"https://creative.adcontextprotocol.org\", \"id\": \"display_300x250\"}. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants. Using a plain string here is a schema violation.",
+                    "x-entity": "creative_format",
+                    "type": "object",
+                    "properties": {
+                      "agent_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "URL of the agent that defines this format (e.g., 'https://creative.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats). Callers comparing two `format-id` values MUST canonicalize `agent_url` per the AdCP URL canonicalization rules before treating two formats as the same. See docs/reference/url-canonicalization."
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[a-zA-Z0-9_-]+$",
+                        "description": "Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant."
+                      },
+                      "width": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "description": "Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."
+                      },
+                      "height": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "description": "Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."
+                      },
+                      "duration_ms": {
+                        "type": "number",
+                        "minimum": 1,
+                        "description": "Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters."
+                      }
+                    },
+                    "required": [
+                      "agent_url",
+                      "id"
+                    ],
+                    "additionalProperties": true,
+                    "dependencies": {
+                      "width": [
+                        "height"
+                      ],
+                      "height": [
+                        "width"
+                      ]
+                    }
+                  }
+                },
+                "snapshot_unavailable_reason": {
+                  "title": "Snapshot Unavailable Reason",
+                  "description": "Machine-readable reason the snapshot is omitted. Present only when include_snapshot was true and snapshot is unavailable for this package.",
+                  "type": "string",
+                  "enum": [
+                    "SNAPSHOT_UNSUPPORTED",
+                    "SNAPSHOT_TEMPORARILY_UNAVAILABLE",
+                    "SNAPSHOT_PERMISSION_DENIED"
+                  ],
+                  "enumDescriptions": {
+                    "SNAPSHOT_UNSUPPORTED": "The seller platform does not support delivery snapshots for this entity",
+                    "SNAPSHOT_TEMPORARILY_UNAVAILABLE": "Snapshot data exists but is temporarily unavailable (e.g., cache miss, pipeline lag)",
+                    "SNAPSHOT_PERMISSION_DENIED": "The caller lacks permission to view snapshot data for this entity"
+                  }
+                },
+                "snapshot": {
+                  "type": "object",
+                  "description": "Near-real-time delivery snapshot for this package. Only present when include_snapshot was true in the request. Represents the latest available entity-level stats from the platform — not billing-grade data.",
+                  "properties": {
+                    "as_of": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "ISO 8601 timestamp when this snapshot was captured by the platform"
+                    },
+                    "staleness_seconds": {
+                      "type": "integer",
+                      "description": "Maximum age of this data in seconds. For example, 900 means the data may be up to 15 minutes old. Use this to interpret zero delivery: a value of 900 means zero impressions is likely real; a value of 14400 means reporting may still be catching up.",
+                      "minimum": 0
+                    },
+                    "impressions": {
+                      "type": "number",
+                      "description": "Total impressions delivered since package start",
+                      "minimum": 0
+                    },
+                    "spend": {
+                      "type": "number",
+                      "description": "Total spend since package start, denominated in snapshot.currency when present, otherwise package.currency or media_buy.currency",
+                      "minimum": 0
+                    },
+                    "currency": {
+                      "type": "string",
+                      "description": "ISO 4217 currency code for spend in this snapshot. Optional when unchanged from package.currency or media_buy.currency.",
+                      "pattern": "^[A-Z]{3}$"
+                    },
+                    "clicks": {
+                      "type": "number",
+                      "description": "Total clicks since package start (when available)",
+                      "minimum": 0
+                    },
+                    "pacing_index": {
+                      "type": "number",
+                      "description": "Current delivery pace relative to expected (1.0 = on track, <1.0 = behind, >1.0 = ahead). Absent when pacing cannot be determined.",
+                      "minimum": 0
+                    },
+                    "delivery_status": {
+                      "type": "string",
+                      "description": "Operational delivery state of this package. 'not_delivering' means the package is within its scheduled flight but has delivered zero impressions for at least one full staleness cycle — the signal for automated price adjustments or buyer alerts. Implementers must not return 'not_delivering' until at least staleness_seconds have elapsed since package activation.",
+                      "enum": [
+                        "delivering",
+                        "not_delivering",
+                        "completed",
+                        "budget_exhausted",
+                        "flight_ended",
+                        "goal_met"
+                      ]
+                    },
+                    "ext": {
+                      "title": "Extension Object",
+                      "description": "Optional extension object for seller-specific snapshot fields.",
+                      "type": "object",
+                      "additionalProperties": true
+                    }
+                  },
+                  "required": [
+                    "as_of",
+                    "staleness_seconds",
+                    "impressions",
+                    "spend"
+                  ],
+                  "additionalProperties": true
+                },
+                "ext": {
+                  "title": "Extension Object",
+                  "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              },
+              "required": [
+                "package_id"
+              ],
+              "additionalProperties": true
+            }
+          },
+          "ext": {
+            "title": "Extension Object",
+            "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "required": [
+          "media_buy_id",
+          "status",
+          "currency",
+          "total_budget",
+          "packages"
+        ],
+        "additionalProperties": true
+      }
+    },
+    "errors": {
+      "type": "array",
+      "description": "Task-specific errors (e.g., media buy not found)",
+      "items": {
+        "title": "Error",
+        "description": "Standard error structure for task-specific errors and warnings",
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "description": "Error code for programmatic handling. Standard codes are defined in error-code.json and enable autonomous agent recovery. Sellers MAY use codes not in the standard vocabulary for platform-specific errors; agents MUST handle unknown codes gracefully by falling back to the recovery classification."
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable error message"
+          },
+          "field": {
+            "type": "string",
+            "description": "Field path associated with the error (e.g., 'packages[0].targeting')"
+          },
+          "suggestion": {
+            "type": "string",
+            "description": "Suggested fix for the error"
+          },
+          "retry_after": {
+            "type": "number",
+            "description": "Seconds to wait before retrying the operation. Sellers MUST return values between 1 and 3600. Clients MUST clamp values outside this range.",
+            "minimum": 1,
+            "maximum": 3600
+          },
+          "details": {
+            "type": "object",
+            "description": "Additional task-specific error details",
+            "additionalProperties": true
+          },
+          "recovery": {
+            "type": "string",
+            "enum": [
+              "transient",
+              "correctable",
+              "terminal"
+            ],
+            "description": "Agent recovery classification. transient: retry after delay (rate limit, service unavailable, timeout). correctable: fix the request and resend (invalid field, budget too low, creative rejected). terminal: requires human action (account suspended, payment required, account not found)."
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "additionalProperties": true
+      }
+    },
+    "pagination": {
+      "title": "Pagination Response",
+      "description": "Pagination metadata for the media_buys array.",
+      "type": "object",
+      "properties": {
+        "has_more": {
+          "type": "boolean",
+          "description": "Whether more results are available beyond this page"
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Opaque cursor to pass in the next request to fetch the next page. Only present when has_more is true."
+        },
+        "total_count": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total number of items matching the query across all pages. Optional because not all backends can efficiently compute this."
+        }
+      },
+      "required": [
+        "has_more"
+      ],
+      "additionalProperties": false
+    },
+    "sandbox": {
+      "type": "boolean",
+      "description": "When true, this response contains simulated data from sandbox mode."
+    },
+    "context": {
+      "title": "Context Object",
+      "description": "Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.",
+      "type": "object",
+      "additionalProperties": true
+    },
+    "ext": {
+      "title": "Extension Object",
+      "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "media_buys"
+  ],
+  "additionalProperties": true,
+  "$defs": {
+    "CanceledBy": {
+      "title": "Canceled By",
+      "description": "Which party initiated the cancellation.",
+      "type": "string",
+      "enum": [
+        "buyer",
+        "seller"
+      ],
+      "enumDescriptions": {
+        "buyer": "Cancellation initiated by the buyer via update_media_buy",
+        "seller": "Cancellation initiated by the seller (e.g., policy violation, inventory withdrawal)"
+      }
+    },
+    "MetroAreaSystem": {
+      "title": "Metro Area System",
+      "description": "Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')",
+      "type": "string",
+      "enum": [
+        "nielsen_dma",
+        "uk_itl1",
+        "uk_itl2",
+        "eurostat_nuts2",
+        "custom"
+      ]
+    },
+    "PostalCodeSystem": {
+      "title": "Postal Code System",
+      "description": "Postal code system (e.g., 'us_zip', 'gb_outward'). System name encodes country and precision.",
+      "type": "string",
+      "enum": [
+        "us_zip",
+        "us_zip_plus_four",
+        "gb_outward",
+        "gb_full",
+        "ca_fsa",
+        "ca_full",
+        "de_plz",
+        "fr_code_postal",
+        "au_postcode",
+        "ch_plz",
+        "at_plz"
+      ]
+    },
+    "DeviceType": {
+      "title": "Device Type",
+      "description": "Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.",
+      "type": "string",
+      "enum": [
+        "desktop",
+        "mobile",
+        "tablet",
+        "ctv",
+        "dooh",
+        "unknown"
+      ]
+    },
+    "MatchType": {
+      "title": "Match Type",
+      "description": "Keyword targeting match type. broad: ads may serve on queries semantically related to the keyword. phrase: ads serve when the query contains the keyword phrase. exact: ads serve only when the query matches the keyword exactly.",
+      "type": "string",
+      "enum": [
+        "broad",
+        "phrase",
+        "exact"
+      ],
+      "enumDescriptions": {
+        "broad": "Ads may serve on queries semantically related to the keyword",
+        "phrase": "Ads serve when the query contains the keyword phrase in order",
+        "exact": "Ads serve only when the query matches the keyword exactly"
+      }
+    }
+  },
+  "_bundled": {
+    "generatedAt": "2026-04-28T12:32:22.986Z",
+    "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
+  }
+}