Skip to main content
GET /api/v2/storefront/intelligence-runs/{id} Fetches one intelligence-run record by id, including the full prompt, raw and parsed model output, run rationale, composed product ids, and any evaluator label.

​
Request

curl
curl https://api.interchange.io/api/v2/storefront/intelligence-runs/42 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldInTypeRequiredNotes
idpathintegerYesSurrogate id of the intelligence-run row

​
Response

{
  "id": "42",
  "storefrontId": "1234",
  "buyerCustomerId": 5678,
  "operatingInstructionsVersion": 3,
  "buyerScope": { "operatorDomain": "acme-media.com", "brandDomain": "northwind.example", "country": "US" },
  "buyerInstructions": { "matchedRowIds": ["17"], "effectiveDiscountPercent": 15, "notes": ["Brand requires acme-agency viewability ≥ 70%."] },
  "brief": "Premium CTV for a Q3 product launch",
  "buyingMode": "decisioned",
  "inventorySnapshot": {},
  "prompt": "Compose products for the buyer brief...",
  "rawLlmOutput": {},
  "parsedOutput": {},
  "runRationale": "Two CTV products matched the brief and budget.",
  "explanation": {
    "summary": "Selected 2 CTV products.",
    "selectedProducts": [
      {
        "productId": "prod_ctv_premium",
        "name": "Premium CTV — Prime",
        "description": "Prime-time CTV avails.",
        "reasoning": "Matched the premium video brief.",
        "pricing": { "baseCpm": 42, "currency": "USD", "operatorDiscount": 15, "finalCpm": 35.7 },
        "bundleIds": [],
        "signalIds": [],
        "formatIds": []
      }
    ],
    "unpricedProducts": [],
    "buyerInstructionNotes": ["Brand requires acme-agency viewability ≥ 70%."],
    "pricingNotes": [],
    "failure": null
  },
  "composedProductIds": ["prod_ctv_premium", "prod_ctv_sports"],
  "result": { "kind": "ok", "code": null, "message": null },
  "modelProvider": "anthropic",
  "modelName": "claude-sonnet",
  "durationMs": 1840,
  "refineSnapshot": null,
  "refinementAppliedSnapshot": null,
  "requestAsks": [],
  "shownProductsSnapshot": {},
  "pricingSummary": {},
  "negotiationSummary": {},
  "commercialOutcome": {},
  "evalLabel": null,
  "createdAt": "2026-06-06T15:00:00.000Z"
}
See Intelligence runs overview for the full field reference, including the explanation and result shapes.

​
Errors

  • 404 NOT_FOUND — no run with that id on your storefront.
  • 401 UNAUTHORIZED — missing or invalid bearer token.
See Errors for the full error contract.

Intelligence run tasks

All intelligence-run operations.

Label intelligence run

Attach an evaluator label to a run.