> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Review your setup draft

> Read the research-backed setup draft produced for approved Media Company applicants

`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.

<Note>
  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.
</Note>

## 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

```http theme={null}
GET /api/v2/supply-intake-setup-draft
Authorization: Bearer <token>
```

No body or query parameters.

## Response

```json theme={null}
{
  "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.