Skip to main content
Market readiness answers a narrow question before buyer setup: is this ISO country × channel cell open for a pilot, and what public-safe supply applies? It does not admit an account. Buyer signup and every authenticated buyer API remain behind the existing alpha-opt-in gate. A storefront appearing in the supply read also never opens a pilot cell; opening and closing are explicit, audited human decisions.

​
Request readiness

Call POST /api/v2/market-readiness with one to 50 cells. This endpoint is public and rate-limited. Country codes use assigned ISO 3166-1 alpha-2 values. Send country codes in uppercase. Supported canonical channels are audio, ctv, display, dooh, social, meta, and google; channel values are lowercase. meta and google are globally governed platform overlays.
Each result includes:
  • pilotState: the effective open or closed decision;
  • pilotScope: domestic, global_overlay, or none;
  • domesticSupply and globalSupply, kept separate;
  • up to 10 public names from human-reviewed listed storefronts (while storefrontCount remains the full usable count); and
  • sourceHealth, which is healthy, degraded, or unknown.
Only active sources from human-reviewed LISTED storefronts contribute to public status, counts, names, or health. Hidden storefronts cannot be inferred from a count, and pending or disabled sources are not treated as available supply. Global supply is an overlay, not a made-up country. An open global social path can therefore apply to Indonesia while Indonesia display remains closed.

​
Unknown is not empty

If the supply query or source-health projection fails, the endpoint returns status: "unknown", storefrontCount: null, and sourceHealth: "unknown". It never turns a failed read into a claim that the market has no supply. status: "none" is returned only after the supply read succeeds and finds no usable source for that scope.