Skip to main content
GET
List storefront intelligence-run records

Authorizations

Authorization
string
header
required

API key or access token

Query Parameters

skip
integer
default:0

Number of rows to skip (offset pagination).

Required range: 0 <= x <= 9007199254740991
Example:

0

take
integer
default:25

Number of rows to return per page (1–100).

Required range: 1 <= x <= 100
Example:

25

disposition
enum<string>

Demand-inbox filter — return only runs with this brief outcome: responded (the storefront composed a response), declined_fit (declined: no matching inventory), declined_policy (declined: acceptance-policy violation), or not_live (brief arrived before the storefront was live; reserved, not yet emitted). Omit to return every outcome.

Available options:
responded,
declined_fit,
declined_policy,
not_live
Example:

"declined_fit"

q
string

Case-insensitive substring search over the buyer brief text. Use to find every brief mentioning a vertical, advertiser, or term (e.g. fintech). Combines with disposition.

Required string length: 1 - 200
Example:

"fintech"

buyingMode
enum<string>

Filter by buying mode — brief for the demand inbox (excludes wholesale/refine runs), wholesale, or refine. Omit to return every mode.

Available options:
brief,
wholesale,
refine
Example:

"brief"

commercialResult
enum<string>

Filter by the commercial result that followed the storefront response, derived from the latest attributed commercial-outcome event: booked (the media buy was forwarded upstream or has reported delivery — a confirmed commitment), pending (the media buy is awaiting the operator’s own acceptance-policy approval and could still be rejected), or rejected (the storefront rejected the media buy). Runs with no attributed media buy yet match no value. There is no lost value — a buyer silently passing on a response has no signal in AdCP today.

Available options:
booked,
pending,
rejected
Example:

"booked"

view
enum<string>
default:full

full (default) returns every run field. summary omits the heavy LLM payload columns (prompt, raw/inventory snapshots) the demand inbox does not render, keeping the response small. The full row is always available on GET /intelligence-runs/:id.

Available options:
summary,
full
Example:

"summary"

Response

List storefront intelligence-run records

List of intelligence runs for a storefront.

items
object[]
required
total
integer
required
Required range: 0 <= x <= 9007199254740991