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

# Get intelligence run

> Fetch one intelligence-run record in full

`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

```bash curl theme={null}
curl https://api.interchange.io/api/v2/storefront/intelligence-runs/42 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Field | In   | Type    | Required | Notes                                    |
| ----- | ---- | ------- | -------- | ---------------------------------------- |
| `id`  | path | integer | Yes      | Surrogate id of the intelligence-run row |

## Response

```json theme={null}
{
  "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](/v2/storefront/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](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Intelligence run tasks" href="/v2/storefront/intelligence-runs/tasks" icon="list-check">
    All intelligence-run operations.
  </Card>

  <Card title="Label intelligence run" href="/v2/storefront/intelligence-runs/tasks/label-intelligence-run" icon="tag">
    Attach an evaluator label to a run.
  </Card>
</CardGroup>