Confirm Media Company identity

POST /api/v2/media-company-intake/confirm The Media Company pre-application identity, seller-product, and billing-country Task (see Confirming your company) confirms four things in one call: the company name and domain, its mutable seller product, the ISO billing country of the contracting company, and baseline Terms of Service acceptance with Privacy Policy disclosure. This endpoint is gated to the early-access cohort enrolled in the media-company-intake rollout; an unenrolled caller never reaches it (see Start intake below). Reusing the sign-up email’s verified domain unedited marks identity VERIFIED; correcting the domain to anything else is recorded as an unverified applicant claim (CLAIMED) — never treated as proof of control. The billing country is the sole input to billingMarket.derivedPlanCurrency. There is no currency picker and no silent USD fallback: an unsupported country returns 422 BILLING_COUNTRY_UNSUPPORTED instead of a currency. operatingMode is LISTING_ONLY or AGENTIC_MEDIA_COMPANY. Listing is included in both choices. LISTING_ONLY lists and manages inventory without Scope3 merchandising, using an agent operated by the company, a partner, or another provider. The agent can be connected during setup; it does not need to exist at signup. AGENTIC_MEDIA_COMPANY adds Scope3’s hosted Merchandising Agent, which the company trains for its business; its inventory can come from an ad server, modular source, external Agent, or linked Storefront. The choice can be changed later in Account settings or with PATCH /api/v2/storefront. The initial capability state commits atomically with this intake revision. The intake response remains the original audit answer after onboarding; GET /api/v2/storefront is the authority for the current setting. It does not describe who authored an Agent, choose a package, or change how an individual inventory Source is treated.

Request

curl

curl -X POST https://api.interchange.io/api/v2/media-company-intake/confirm \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedRevision": 1,
    "companyName": "Acme Media",
    "companyDomain": "acme.com",
    "billingCountryAlpha2": "US",
    "operatingMode": "LISTING_ONLY",
    "acceptedTermsOfService": true
  }'

Field	Type	Required	Notes
`expectedRevision`	integer	Yes	Optimistic-concurrency fence — the durable application’s current revision
`companyName`	string	Yes	Confirmed or corrected company name
`companyDomain`	string	Yes	Confirmed or corrected bare registrable domain (no scheme, no path)
`billingCountryAlpha2`	string	Yes	ISO 3166-1 alpha-2 country of the contracting company — not the applicant’s personal location
`operatingMode`	`"LISTING_ONLY"` \| `"AGENTIC_MEDIA_COMPANY"`	No	Mutable seller product: listing without Scope3 merchandising, or listing plus Scope3 merchandising. Current onboarding sends this field; omission remains accepted temporarily for clients deployed before the selector and leaves the product unselected.
`acceptedTermsOfService`	`true`	Yes	Must reflect genuine applicant agreement. Recorded as a durable, idempotent Terms of Service acceptance

Response

200 confirmed

{
  "applicationId": "app_123",
  "expectedRevision": 2,
  "status": "RESEARCHING",
  "identity": {
    "proposedName": "Acme Media",
    "proposedDomain": "acme.com",
    "confirmedName": "Acme Media",
    "confirmedDomain": "acme.com",
    "verificationState": "VERIFIED",
    "userConfirmed": true
  },
  "billingMarket": {
    "suggestedCountryAlpha2": null,
    "confirmedCountryAlpha2": "US",
    "userConfirmed": true,
    "derivedPlanCurrency": "USD"
  },
  "operatingMode": "LISTING_ONLY",
  "unresolvedQuestion": null
}

Field	Type	Description
`applicationId`	string	Durable intake application id
`expectedRevision`	integer	Current revision — pass this back on the next confirm call
`status`	string	One of `AWAITING_IDENTITY_CONFIRMATION`, `RESEARCHING`, `NEEDS_APPLICANT_INPUT`, `EXCEPTION_REVIEW`, `APPROVED`, `DENIED`
`identity.proposedName` / `identity.proposedDomain`	string	The originally-proposed company name/domain, derived from the sign-up email
`identity.confirmedName` / `identity.confirmedDomain`	string \| null	The applicant-confirmed values, once confirmed
`identity.verificationState`	`"VERIFIED"` \| `"CLAIMED"` \| `"CONFLICTING"` \| null	`VERIFIED` only when the confirmed domain matches the verified sign-up email’s domain unedited
`identity.userConfirmed`	boolean	Whether the applicant has confirmed identity
`billingMarket.suggestedCountryAlpha2`	string \| null	A prefetched country suggestion, when available
`billingMarket.confirmedCountryAlpha2`	string \| null	The applicant-confirmed billing country
`billingMarket.userConfirmed`	boolean	Whether the applicant has confirmed the billing country
`billingMarket.derivedPlanCurrency`	string \| null	The plan currency Scope3 derives from the confirmed billing country — never client-supplied
`operatingMode`	`"LISTING_ONLY"` \| `"AGENTIC_MEDIA_COMPANY"` \| null	Original applicant intake selection; null before the applicant chooses. Read Storefront for the mutable current setting.
`unresolvedQuestion`	string \| null	A single outstanding question, only when `status` is `NEEDS_APPLICANT_INPUT`

A RESEARCHING status starts a short, usually few-second, admission check. Poll GET /api/v2/media-company-intake (below) to observe the transition to APPROVED or another terminal/interactive status; refreshing or re-calling this Task always resumes the same durable state rather than restarting it.

Errors

400 VALIDATION_ERROR — malformed request body.
403 FEATURE_NOT_ENABLED — the caller is not enrolled in Media Company intake.
409 CONFLICT — either no intake application exists yet (call POST /api/v2/media-company-intake first) or expectedRevision does not match the current durable revision (optimistic-concurrency conflict — re-read with GET /api/v2/media-company-intake and retry with the current revision).
422 BILLING_COUNTRY_UNSUPPORTED — the confirmed billing country is not yet supported for plan billing. The response includes the rejected countryAlpha2 in details; no currency is guessed.

See Errors for the full error contract.

Start or resume intake

POST /api/v2/media-company-intake is the Task’s idempotent open action — call it first to create (or replay) the durable application seeded from the verified sign-up email domain. It returns the same view shape as this endpoint’s 200 response above, and returns 403 FEATURE_NOT_ENABLED when the caller is not enrolled. GET /api/v2/media-company-intake reads the current durable state without creating one — use it to poll a RESEARCHING application, or to resume after a page refresh or re-login. Returns 404 NOT_FOUND when no application exists yet.

Storefront tasks

All core storefront operations.

Get readiness

Check whether your storefront is ready to go live, once admitted.

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Confirm Media Company identity

Request

Response

Errors

Start or resume intake

Storefront tasks

Get readiness

​Request

​Response

​Errors

​Start or resume intake

​Related

Storefront tasks

Get readiness

Request

Response

Errors

Start or resume intake

Related