Review your setup draft

GET /api/v2/supply-intake-setup-draft Once your Media Company intake application is approved and the research pipeline finishes, Scope3 produces a reviewable setup draft for your organization. The draft surfaces inferred company profile, operating role, candidate properties and domains, markets and channels, likely inventory sources, and selling-path guidance. Operating role, properties, and scopes carry provenance labels so you know which of those suggestions to validate; other fields do not claim a provenance label.

The setup draft is research-backed evidence to help you configure your Storefront. It is not an automatically applied configuration: no billing setting, property control, Marketplace authority, or Market Maker entitlement is granted from the draft alone.

Authentication

Bearer token with a STOREFRONT role. The endpoint is gated to the media-company-intake rollout; an unenrolled caller receives 404 so rollout membership is not disclosed.

Request

GET /api/v2/supply-intake-setup-draft
Authorization: Bearer <token>

No body or query parameters.

Response

{
  "data": {
    "draft": {
      "applicationId": "uuid",
      "sourceRevision": 2,
      "companyName": "Acme Media Inc.",
      "companyDomain": "acmemedia.com",
      "billingCountryAlpha2": "US",
      "derivedPlanCurrency": "USD",
      "operatingRole": {
        "kind": "DIRECT_PUBLISHER",
        "confidence": 0.87,
        "provenance": "INFERRED"
      },
      "properties": [
        {
          "domain": "acmemedia.com",
          "relationship": "OWNED",
          "confidence": 0.95,
          "provenance": "INFERRED"
        }
      ],
      "scopes": [
        {
          "market": "US",
          "channel": "DISPLAY",
          "confidence": 0.82,
          "provenance": "INFERRED"
        }
      ],
      "setupIntent": "THIRD_PARTY_CONNECT",
      "sourceCandidates": ["GAM", "XANDR"],
      "suggestedSettlementCurrency": "USD",
      "adagentsGuidance": {
        "canonicalDomain": "acmemedia.com",
        "draftContent": "{ \"authorized_agents\": [] }",
        "validationErrors": [
          "Add the executable HTTPS URL of your AdCP sales agent before publishing; the company website is not an agent URL."
        ]
      },
      "computedAt": "2026-09-02T00:00:00Z"
    }
  },
  "error": null
}

Returns { "data": { "draft": null }, "error": null } when no projection has been computed yet (research still in progress, or exact-preapproval path with no shadow research).

Field reference

Field	Type	Provenance	Notes
`companyName`	string \| null	—	Company name from identity confirmation
`companyDomain`	string \| null	—	Canonical domain used for adagents.json guidance
`billingCountryAlpha2`	string \| null	APPLICANT_CONFIRMED	ISO alpha-2 country code confirmed at signup
`derivedPlanCurrency`	string \| null	—	Suggestion only — never auto-applied to billing
`operatingRole.kind`	string \| null	INFERRED	Research-inferred role: DIRECT_PUBLISHER, AUTHORIZED_REPRESENTATIVE, NETWORK_OR_EXCHANGE
`operatingRole.confidence`	number \| null	—	0–1 confidence from shadow research
`properties[].provenance`	string	INFERRED	The domain relationship is research-derived. Confirming company identity does not confirm ownership or representation.
`suggestedSettlementCurrency`	string \| null	—	Suggestion only — set it in Plan & Billing, never here
`adagentsGuidance.draftContent`	string	—	JSON draft for review — never published automatically

Provenance labels

When a field carries a provenance value, it tells you how Scope3 obtained that suggestion:

INDEPENDENTLY_VERIFIED — confirmed by an external business registry
APPLICANT_CONFIRMED — you explicitly confirmed this value at signup
INFERRED — derived from public research; review before accepting

Settlement currency

suggestedSettlementCurrency is a research-backed suggestion. To set your actual settlement currency, go to Plan & Billing in your account settings. The draft never changes your billing configuration.

adagents.json guidance

adagentsGuidance.draftContent is a safe adagents.json scaffold for your confirmed domain. Signup does not establish your executable AdCP agent URL, so the scaffold leaves authorized_agents empty instead of treating your company website as an agent. Add and verify the executable HTTPS agent URL, attach only properties you are authorized to represent, then publish the file through your normal domain deployment process. Scope3 never publishes it for you.

MCP tool

Available via Murph as get_supply_intake_setup_draft (no arguments required). The tool returns the same applicant-safe view as this REST endpoint.

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Review your setup draft

Authentication

Request

Response

Field reference

Provenance labels

Settlement currency

adagents.json guidance

MCP tool

​Authentication

​Request

​Response

​Field reference

​Provenance labels

​Settlement currency

​adagents.json guidance

​MCP tool

Authentication

Request

Response

Field reference

Provenance labels

Settlement currency

adagents.json guidance

MCP tool